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

Определение

Описывает, каким образом операционная система должна открывать файл.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
Наследование
FileMode
Атрибуты

Поля

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 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 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 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 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 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.

Open IsolatedStorageFileStream FileStream FileInfo Параметр задается во многих конструкторах для, и в методах File и для управления способом открытия файла. FileModeA 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.

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

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