CFile::CFile 

CFile( );

CFile ( int hFile );

CFile ( LPCTSTR lpszFileName, UINT nOpenFlags );
кинути ( CFileException );

Параметри

hFile

Дескриптор файлу, який уже відкрито.

lpszFileName

Рядок, який є шлях до потрібного файлу. Шлях може бути відносну або абсолютну.

nOpenFlags

Спільний доступ і доступ до режиму. Задає дію взяти під час відкриття файлу. Ви можете об'єднати опції перераховані нижче за допомогою оператора порозрядне OR (|). Один доступу та параметр одна акція обов'язкові; Необов'язкові modeCreate та modeNoInherit режимах. Значення є наступні:

• CFile::modeCreate   Керує конструктор для створення нового файлу. Якщо файл вже існує, він скорочується до 0 довжини.
  
  
• CFile::mode&NoTruncatenbsp;  Поєднати це значення з modeCreate. Якщо файл, який створюється вже існує, не скорочується до 0 довжини. Таким чином файл гарантується для відкриття, як знову створеного файлу або існуючий файл. Це може бути корисним, наприклад, під час відкриття файлу параметрів, які можуть або не існує вже. Цей параметр застосовується до 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. Тому, що даний Конструктор закинути не є винятком, вона не має сенсу використовувати, СПРОБУЙТЕ/ЗЛОВИТИ логіки. Використовується функція відкритим члена, а потім перевірити безпосередньо за винятком умов. Для обговорення стратегії обробки винятків, перегляньте статтю - Винятки в Visual C++ програміста керівництво.

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

Конструктор з два аргументи створює CFile об'єкта і відкриває відповідних файлів операційної системи з даної шляхом. Даний конструктор поєднує в собі функції першого Конструктор і відкритим члена функції. Вона кидає виключення, якщо відбувається помилка під час відкриття файлу. Як правило, це означає, що критична помилка і користувач повинен бути попереджені.

Приклад

//example для CFile::CFile
Чар * pFileName = "test.dat";
СПРОБУЙТЕ
{
   CFile f (pFileName, CFile::modeCreate | CFile::modeWrite);
}
УЛОВ ("CFileException", "e")
{
   #IFDEF _DEBUG
      afxDump lt; < "Не вдається відкрити файл" << e-> m_cause << "\n";
   #endif
}
END_CATCH

Огляд CFile |  Члени класу | Ієрархічна діаграма