FileMode Перечисление

Определение

Указывает, каким образом операционная система должна открыть файл.

public enum class FileMode
public enum FileMode
[System.Serializable]
public enum FileMode
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public enum FileMode
type FileMode = 
[<System.Serializable>]
type FileMode = 
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type FileMode = 
Public Enum FileMode
Наследование
FileMode
Атрибуты

Поля

Append 6

Открывает файл, если он существует, и находит конец файла; либо создает новый файл. Для этого требуется разрешение Append. FileMode.Append можно использовать только вместе с FileAccess.Write. Попытка поиска положения перед концом файла вызывает исключение IOException, и любая попытка чтения заканчивается неудачей, и создает исключение NotSupportedException.

Create 2

Указывает, что операционная система должна создавать новый файл. Если файл уже существует, он будет перезаписан. Для этого требуется разрешение Write. Значение FileMode.Create эквивалентно требованию использовать значение CreateNew, если файл не существует, и значение Truncate в противном случае. Если файл уже существует, но является скрытым, создается исключение UnauthorizedAccessException.

CreateNew 1

Указывает, что операционная система должна создавать новый файл. Для этого требуется разрешение Write. Если файл уже существует, создается исключение IOException.

Open 3

Указывает, что операционная система должна открыть существующий файл. Возможность открыть данный файл зависит от значения, задаваемого перечислением FileAccess. Исключение FileNotFoundException создается, если файл не существует.

OpenOrCreate 4

Указывает, что операционная система должна открыть файл, если он существует, в противном случае должен быть создан новый файл. Если файл открыт с помощью FileAccess.Read, требуется разрешение Read. Если доступ к файлу является FileAccess.Write, требуется разрешение Write. Если файл открыт с помощью FileAccess.ReadWrite, требуются разрешения Read и Write.

Truncate 5

Указывает, что операционная система должна открыть существующий файл. Если файл открыт, он должен быть усечен таким образом, чтобы его размер стал равен нулю байтов. Для этого требуется разрешение Write. Попытки выполнить чтение из файла, открытого с помощью FileMode.Truncate, вызывают исключение ArgumentException.

Примеры

FileStream Следующий конструктор открывает существующий файл (FileMode.Open).

FileStream^ s2 = gcnew FileStream( name, FileMode::Open, FileAccess::Read, FileShare::Read );
FileStream s2 = new FileStream(name, FileMode.Open, FileAccess.Read, FileShare.Read);
Dim s2 As New FileStream(name, FileMode.Open, FileAccess.Read, FileShare.Read)

Комментарии

Пример создания файла и записи текста в файл см. в разделе "Практическое руководство. Запись текста в файл". Пример чтения текста из файла см. в разделе "Практическое руководство. Чтение текста из файла". Пример чтения и записи в двоичный файл см. в разделе "Практическое руководство. Чтение и запись в только что созданный файл данных".

Параметр FileMode указывается во многих конструкторах для FileStream, IsolatedStorageFileStreamа также в Open методах File открытия файла и FileInfo для управления открытием файла.

FileMode параметры определяют, перезаписывается ли файл, создается, открывается или используется какое-либо сочетание. Используется для Open открытия существующего файла. Чтобы добавить файл, используйте Append. Чтобы усечь файл или создать файл, если он не существует, используйте Create.

Применяется к

См. также раздел