FileMode FileMode FileMode FileMode Enum

Определение

Описывает, каким образом операционная система должна открывать файл.Specifies how the operating system should open a file.

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

Поля

Append Append Append Append 6

Открывает файл, если он существует, и находит конец файла; либо создает новый файл.Opens the file if it exists and seeks to the end of the file, or creates a new file. Для этого требуется разрешение Append.This requires Append permission. FileMode.Append можно использовать только вместе с FileAccess.Write.FileMode.Append can be used only in conjunction with FileAccess.Write. Попытка поиска положения перед концом файла вызывает исключение IOException, и любая попытка чтения заканчивается неудачей, и создает исключение NotSupportedException.Trying to seek to a position before the end of the file throws an IOException exception, and any attempt to read fails and throws a NotSupportedException exception.

Create Create Create Create 2

Указывает, что операционная система должна создавать новый файл.Specifies that the operating system should create a new file. Если файл уже существует, он будет перезаписан.If the file already exists, it will be overwritten. Для этого требуется разрешение Write.This requires Write permission. Значение FileMode.Create эквивалентно требованию использовать значение CreateNew, если файл не существует, и значение Truncate в противном случае.FileMode.Create is equivalent to requesting that if the file does not exist, use CreateNew; otherwise, use Truncate. Если файл уже существует, но является скрытым, создается исключение UnauthorizedAccessException.If the file already exists but is a hidden file, an UnauthorizedAccessException exception is thrown.

CreateNew CreateNew CreateNew CreateNew 1

Указывает, что операционная система должна создавать новый файл.Specifies that the operating system should create a new file. Для этого требуется разрешение Write.This requires Write permission. Если файл уже существует, создается исключение IOException.If the file already exists, an IOException exception is thrown.

Open Open Open Open 3

Указывает, что операционная система должна открыть существующий файл.Specifies that the operating system should open an existing file. Возможность открыть данный файл зависит от значения, задаваемого перечислением FileAccess.The ability to open the file is dependent on the value specified by the FileAccess enumeration. Исключение FileNotFoundException создается, если файл не существует.A FileNotFoundException exception is thrown if the file does not exist.

OpenOrCreate OpenOrCreate OpenOrCreate OpenOrCreate 4

Указывает, что операционная система должна открыть файл, если он существует, в противном случае должен быть создан новый файл.Specifies that the operating system should open a file if it exists; otherwise, a new file should be created. Если файл открыт с помощью FileAccess.Read, требуется разрешение Read.If the file is opened with FileAccess.Read, Read permission is required. Если доступ к файлу является FileAccess.Write, требуется разрешение Write.If the file access is FileAccess.Write, Write permission is required. Если файл открыт с помощью FileAccess.ReadWrite, требуются разрешения Read и Write.If the file is opened with FileAccess.ReadWrite, both Read and Write permissions are required.

Truncate Truncate Truncate Truncate 5

Указывает, что операционная система должна открыть существующий файл.Specifies that the operating system should open an existing file. Если файл открыт, он должен быть усечен таким образом, чтобы его размер стал равен нулю байтов.When the file is opened, it should be truncated so that its size is zero bytes. Для этого требуется разрешение Write.This requires Write permission. Попытки выполнить чтение из файла, открытого с помощью FileMode.Truncate, вызывают исключение ArgumentException.Attempts to read from a file opened with FileMode.Truncate cause an ArgumentException exception.

Примеры

Следующие FileStream конструктор открывает существующий файл (FileMode.Open).The following FileStream constructor opens an existing file (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)

Комментарии

Пример создания файла и записи текста в файл, см. в разделе как: Запись текста в файл.For an example of creating a file and writing text to a file, see How to: Write Text to a File. Пример чтения текста из файла, см. в разделе как: Чтение текста из файла.For an example of reading text from a file, see How to: Read Text from a File. Например, чтение и запись в двоичный файл, см. в разделе как: Чтение и запись в файл данных только что созданный.For an example of reading from and writing to a binary file, see How to: Read and Write to a Newly Created Data File.

Объект FileMode параметр задается во многих конструкторах объектов FileStream, IsolatedStorageFileStream, а затем в Open методы File и FileInfo для управления, как открыть файл.A FileMode parameter is specified in many of the constructors for FileStream, IsolatedStorageFileStream, and in the Open methods of File and FileInfo to control how a file is opened.

FileMode Параметры управления, будет ли перезаписан файл создан, открыт, или некоторого сочетания этих параметров.FileMode parameters control whether a file is overwritten, created, opened, or some combination thereof. Используйте Open для открытия существующего файла.Use Open to open an existing file. Чтобы добавить в файл, используйте Append.To append to a file, use Append. Чтобы выполнить усечение файла или создать файл, если он не существует, используйте Create.To truncate a file or create a file if it doesn't exist, use Create.

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

Дополнительно