CFile::CFile 

CFile( );

CFile ( int hFile );

CFile ( LPCTSTR lpszFileName, UINT nOpenFlags );
бросить ( CFileException );

Параметры

hFile

Дескриптор файла, который уже открыт.

lpszFileName

Строка, содержащая путь к нужному файлу. Путь может быть относительным или абсолютным.

nOpenFlags

Режим обмена и доступа. Определяет действие, выполняемое при открытии файла. Это сочетание перечисленных ниже, используя оператор побитового или (|). Требуются разрешения на один доступ и одну акцию вариант; modeCreate и modeNoInherit режимы не являются обязательными. Возможны следующие значения:

• CFile::modeCreate   Направляет конструктора для создания нового файла. Если файл уже существует, оно усекается до нулевой длины.
  
  
• CFile::mode&NoTruncatenbsp;  Совместить это значение с modeCreate. Если уже созданный файл существует, он не усекается до нулевой длины. Таким образом гарантируется файл открыть, как только что созданный файл или как существующего файла. Это может пригодиться, например, при открытии файла настроек, который может или не может уже существовать. Этот параметр применяется к CStdioFile , а.
  
  
• CFile::modeRead   Открывает файл только для чтения.
  
  
• CFile::modeReadWrite   Открывает файл для чтения и записи.
  
  
• CFile::modeWrite   Открывает файл только для записи.
  
  
• CFile::mode&NoInheritnbsp;  Предотвращает файл от наследования дочерними процессами.
  
  
• CFile::shareDeny&Nonenbsp;  Открывает файл, не отрицая другие процессы чтения или записи в файл. Создание сбой, если файл открыт в режиме совместимости с любой другой процесс.
  
  
• CFile::shareDe&nyReadnbsp;  Открывает файл и другие процессы чтения доступ к файлу. Создание сбой, если файл открыт в режиме совместимости или для доступа на чтение к любой другой процесс.
  
  
• CFile::shareDe&nyWritenbsp;  Открывает файл и запрещает доступ другие процессы на запись в файл. Создание сбой, если файл открыт в режиме совместимости или для доступа к записи, любой другой процесс.
  
  
• CFile::shareExclusive   Открывает файл в монопольном режиме, отрицая другие процессы как доступ чтения и записи в файл. Строительство сбой, если файл был открыт в любом режиме для чтения или записи, даже в рамках текущего процесса.
  
  
• CFile::shareCompat   Этот флаг не доступен в 32-разрядных MFC. Этот флаг соответствует CFile::shareExclusive при использовании в CFile::Open.
  
  
• CFile::typeText   Задает текстовый режим с особой обработки для перевозки return–linefeed пар (используется в производных классах).
  
  
• CFile::typeBi&narynbsp;  Задает двоичный режим (в производных классах).

Примечания

Конструктор по умолчанию не открыть файл, но скорее устанавливает m_hFile в CFile::hFileNull. Потому что этот конструктор не выбрасывает исключение, он не имеет смысла использовать TRY/CATCH логику. Функции-члена Open , а затем проверить непосредственно исключение условий. Для обсуждения стратегии обработки исключения, обратитесь к статье исключения в Руководстве Visual C++ программист.

Конструктор с одним аргументом создает объект CFile , соответствующий файл операционной системы определенных hFile. Проверка не производится на доступ режима или тип файла. Когда объект CFile уничтожается, файл операционной системы не закрыт. Необходимо закрыть файл самостоятельно.

Конструктор с двумя аргументами создает объект CFile и открывает соответствующий файл операционной системы с заданного пути. Этот конструктор объединяет в себе функции первого конструктора и функции-члена Open . Это создает исключение, если возникает ошибка при открытии файла. Вообще это означает, что ошибка является неустранимой и оповещения пользователя.

Пример

//Example для CFile::CFile
char * pFileName = «test.dat»;
ПОПРОБУЙТЕ
{
   CFile f (pFileName, CFile::modeCreate | CFile::modeWrite);
}
УЛОВ (CFileException, e)
{
   # ifdef _DEBUG
      afxDump lt; < «Не удается открыть файл» << e-> m_cause << «\n»;
   # endif
}
END_CATCH

Обзор CFile |  Члены класса | Иерархическая схема