CFile::CFile

Článek
06/10/2015

Vytvoří a inicializuje CFile objektu.

CFile( ); CFile(    CAtlTransactionManager* pTM ); CFile(    HANDLE hFile  ); CFile(    LPCTSTR lpszFileName,    UINT nOpenFlags  ); CFile(    LPCTSTR lpszFileName,    UINT nOpenFlags,    CAtlTransactionManager* pTM );

Parametry

hFile
Popisovač souboru, chcete-li připojit CFile objektu.
lpszFileName
Relativní nebo celou cestu k souboru, chcete-li připojit CFile objektu.
nOpenFlags
Bitová kombinace (nebo) možnosti přístup k souboru pro zadaný soubor.V části poznámky pro dostupné možnosti.
pTM
Ukazatel na objekt CAtlTransactionManager

Poznámky

V následujících pěti tabulkách jsou uvedeny dostupné možnosti nOpenFlags parametru.

Zvolte pouze jeden z následujících možností režimu přístup k souboru.Výchozí režim přístup k souboru je CFile::modeRead, která je jen pro čtení.

Hodnota	Popis
CFile::modeRead	Žádosti o přístup jen pro čtení.
CFile::modeWrite	Žádosti o přístup pro zápis pouze.
CFile::modeReadWrite	Požadavky na čtení a zápis.

Vyberte jednu z následujících možností režimu znak.

Hodnota	Popis
CFile::typeBinary	Nastaví binární režim (používá se v odvozených třídách pouze).
CFile::typeText	Nastaví režim textové s zvláštní zpracování pro dvojice konce return – konce řádku (používá se v odvozených třídách pouze).
CFile::typeUnicode	Nastaví režim Unicode (používá se v odvozených třídách pouze).Když aplikace je sestavena v konfiguraci Unicode, je text psán na soubor ve formátu Unicode.Bez Kusovníku je zapsán do souboru.

Zvolte pouze jeden z následujících možností režimu sdílení souborů.Je výchozí režim sdílené složky souborů CFile::shareExclusive, který je určen výhradně.

Hodnota	Popis
CFile::shareDenyNone	Žádná sdílení omezení.
CFile::shareDenyRead	Odepře přístup pro čtení pro všechny ostatní.
CFile::shareDenyWrite	Odepře přístup pro zápis všech ostatním uživatelům.
CFile::shareExclusive	Odepře přístup pro čtení a zápis všem ostatním uživatelům.

Zvolte první nebo oba z následujících možností režimu vytvoření souboru.Je výchozí režim vytváření CFile::modeNoTruncate, což je otevřít existující.

Hodnota	Popis
CFile::modeCreate	Vytvoří nový soubor, pokud neexistuje žádný soubor.; Pokud soubor již existuje, CFileException je vyvolána.
CFile::modeNoTruncate	Vytvoří nový soubor, pokud neexistuje žádný soubor; jinak, pokud soubor již existuje, je připojen CFile objektu.

Zvolte následující soubor ukládání do mezipaměti možnosti, jak je popsáno.Ve výchozím nastavení používá systém obecné účely ukládání do mezipaměti schématu, který není k dispozici možnost.

Hodnota	Popis
CFile::osNoBuffer	Systém nepoužívá mezilehlá mezipaměti pro soubor.Tato možnost zruší následující možnosti 2.
CFile::osRandomAccess	Mezipaměť souborů je optimalizována pro náhodný přístup.Nepoužívejte tuto možnost a možnost sekvenční kontroly.
CFile::osSequentialScan	Mezipaměť souborů je optimalizována pro sekvenční přístup.Nepoužívejte tuto možnost a možnost náhodný přístup.
CFile::osWriteThrough	Zapsat neprodleně jsou prováděny operace.

Vyberte následující možnost zabezpečení zabránit zděděna popisovač souboru.Ve výchozím nastavení můžete použít všechny nové podřízené procesy popisovač souboru.

Hodnota	Popis
CFile::modeNoInherit	Všechny podřízené procesy zabrání v používání popisovač souboru.

Výchozí konstruktor inicializuje členy, ale není připojit soubor CFile objektu.Po použití tohoto konstruktoru, použijte CFile::Open metodu pro otevření souboru a připojit se k CFile objektu.

Konstruktor s jedním parametrem inicializuje členy a připojí k existující soubor CFile objektu.

Konstruktor s dvěma parametry inicializuje členy a pokusí se otevřít zadaný soubor.Pokud se tento konstruktor úspěšně otevře zadaný soubor, soubor je připojena k CFile objektu; jinak tento konstruktor vyvolá ukazatel CInvalidArgException objektu.Další informace o tom, jak zpracování výjimek naleznete v tématu výjimky.

Pokud CFile objekt úspěšně otevře zadaný soubor, bude uzavřen tento soubor automaticky při CFile objektu je zničení; jinak, je třeba výslovně zavřít soubor poté, co je již připojena k CFile objektu.

Příklad

Následující kód ukazuje, jak lze použít CFile.

HANDLE hFile = CreateFile(_T("CFile_File.dat"),
   GENERIC_WRITE, FILE_SHARE_READ,
   NULL, CREATE_ALWAYS, FILE_ATTRIBUTE_NORMAL, NULL);

if (hFile == INVALID_HANDLE_VALUE)
{
   AfxMessageBox(_T("Couldn't create the file!"));
}
else
{
   // Attach a CFile object to the handle we have.
   CFile myFile(hFile);

   static const TCHAR sz[] = _T("I love CFile!");

   // write string
   myFile.Write(sz, sizeof(sz));

   // We can call Close() explicitly, but the destructor would have 
   // also closed the file for us. Note that there's no need to 
   // call the CloseHandle() on the handle returned by the API because 
   // MFC will close it for us.
   myFile.Close();

Požadavky

Záhlaví: afx.h

Viz také

Referenční dokumentace

Třída CFile

Graf hierarchie

Sdílet prostřednictvím