CFile::CFile 

CFile( );

CFile ( int hFile );

CFile ( LPCTSTR lpszFileName, UINT nOpenFlags );
gettare ( CException );

Parametri

hFile

La maniglia di un file che è già aperto.

lpszFileName

Una stringa che rappresenta il percorso per il file desiderato. Il percorso può essere relativa o assoluta.

nOpenFlags

Modalità di accesso e condivisione. Specifica l'azione da intraprendere quando si apre il file. È possibile combinare le opzioni elencate di seguito utilizzando l'operatore OR bit per bit (|). L'autorizzazione di un accesso e una condivisione opzione sono richiesti; le modalità modeCreate e modeNoInherit sono facoltative. I valori sono i seguenti:

• CFile:: modeCreate   Dirige il costruttore per creare un nuovo file. Se il file esiste già, esso viene troncato a lunghezza 0.
  
  
• CFile::mode&NoTruncatenbsp;  Questo valore si combinano con modeCreate. Se il file viene creato già esiste, non è troncato di lunghezza 0. Quindi il file è garantito per aprire, come un file appena creato o come un file esistente. Questo potrebbe essere utile, ad esempio, quando si apre un file di impostazioni che possono o non esista già. Questa opzione si applica anche a CStdioFile.
  
  
• ModeRead   Apre il file per la lettura solo.
  
  
• CFile::modeReadWrite   Apre il file per la lettura e la scrittura.
  
  
• CFile::modeWrite   Apre il file per la scrittura solo.
  
  
• CFile::mode&NoInheritnbsp;  Impedisce che il file ereditati dai processi figlio.
  
  
• CFile::shareDeny&Nonenbsp;  Apre il file senza negare altri processi leggere o accesso in scrittura al file. Create non riesce se il file è stato aperto in modalità di compatibilità da qualsiasi altro processo.
  
  
• CFile::shareDe&nyReadnbsp;  Apre il file e nega altri processi accesso in lettura al file. Create non riesce se il file è stato aperto in modalità di compatibilità o per l'accesso in lettura da qualsiasi altro processo.
  
  
• CFile::shareDe&nyWritenbsp;  Apre il file e nega altri processi accesso in scrittura al file. Create non riesce se il file è stato aperto in modalità di compatibilità o per l'accesso in scrittura da qualsiasi altro processo.
  
  
• CFile::shareExclusive   Apre il file con la modalità esclusiva, negando l'accesso in scrittura al file di altri processi sia leggere. Costruzione ha esito negativo se il file è stato aperto in qualsiasi altra modalità per lettura o di accesso in scrittura, anche per il processo corrente.
  
  
• CFile::shareCompat   Questo flag non è disponibile in 32 bit MFC. Questo flag esegue il mapping a CFile::shareExclusive quando viene utilizzato in CFile::Open.
  
  
• CFile::typeText   Imposta la modalità di testo con un'elaborazione speciale per trasporto return–linefeed coppie (utilizzato nelle classi derivate solo).
  
  
• CFile::typeBi&narynbsp;  Imposta la modalità binaria (utilizzata nelle classi derivate solo).

Osservazioni

Il costruttore predefinito non si apre un file ma piuttosto imposta m_hFile su CFile::hFileNull. Perché questo costruttore non genera un'eccezione, esso non ha senso usare TRY/CATCH logica. Utilizzare la funzione membro Open , quindi testare direttamente per le condizioni di eccezione. Per una discussione della strategia di elaborazione delle eccezioni, vedere l'articolo eccezioni nel manuale del programmatore di Visual C++.

Il costruttore con un argomento crea un oggetto CFile che corrisponde a un file di sistema operativo esistente identificato da hFile. Del tipo di file o modalità di accesso non viene effettuato alcun controllo. Quando l'oggetto CFile è distrutto, i file del sistema operativo non sarà chiuso. È necessario chiudere il file te stesso.

Il costruttore con due argomenti crea un oggetto CFile e si apre il corrispondente file di sistema operativo con il percorso specificato. Questo costruttore combina le funzioni del primo costruttore e la funzione membro Open . Esso genera un'eccezione se si verifica un errore durante l'apertura del file. Generalmente, questo significa che l'errore è irreversibile e che l'utente dovrebbe essere avvisato.

Esempio

//example per CFile::CFile
char * pFileName = "test";
PROVARE
{
   CFile f (pFileName, CFile:: modeCreate | CFile::modeWrite);
}
CATCH (CException, e)
{
   ifdef  debug
      afxDump lt; < "File non può essere aperto" << e-> m_cause << "\n";
   # endif
}
END_CATCH

CFile pa&noramica |nbsp; Membri della classe | Gerarchia Chart