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

Определение

Пространство имен:
System.IO
Сборки:
mscorlib.dll, System.IO.FileSystem.Primitives.dll
Сборки:
netstandard.dll, System.Runtime.dll
Сборка:
System.IO.FileSystem.Primitives.dll
Сборка:
System.Runtime.dll
Сборка:
mscorlib.dll
Сборка:
netstandard.dll
Исходный код:
FileMode.cs
Исходный код:
FileMode.cs
Исходный код:
LowLevelMonitor.Unix.cs

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

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
Наследование
Object
ValueType
Enum
FileMode
Атрибуты
SerializableAttribute ComVisibleAttribute

Поля

Имя Значение Описание
CreateNew 1

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

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

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

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

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

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

Примеры

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

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.

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

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