FileMode FileMode FileMode FileMode Enum

Definição

Especifica como o sistema operacional deve abrir um arquivo.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
Herança
Atributos

Campos

Append Append Append Append 6

Abre o arquivo, caso ele exista, e busca o final do arquivo ou cria um novo arquivo.Opens the file if it exists and seeks to the end of the file, or creates a new file. Isso requer a permissão Append.This requires Append permission. FileMode.Append pode ser usado apenas em conjunto com FileAccess.Write.FileMode.Append can be used only in conjunction with FileAccess.Write. Tentar buscar uma posição antes do final do arquivo gera uma exceção IOException e qualquer tentativa de leitura falha e gera uma exceção 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

Especifica que o sistema operacional deve criar um novo arquivo.Specifies that the operating system should create a new file. Se o arquivo já existir, ele será substituído.If the file already exists, it will be overwritten. Isso requer a permissão Write.This requires Write permission. FileMode.Create é equivalente a solicitar que, se o arquivo não existir, CreateNew seja usado; caso contrário, Truncate deverá ser usado.FileMode.Create is equivalent to requesting that if the file does not exist, use CreateNew; otherwise, use Truncate. Se o arquivo já existir, mas for um arquivo oculto, será gerada uma exceção UnauthorizedAccessException.If the file already exists but is a hidden file, an UnauthorizedAccessException exception is thrown.

CreateNew CreateNew CreateNew CreateNew 1

Especifica que o sistema operacional deve criar um novo arquivo.Specifies that the operating system should create a new file. Isso requer a permissão Write.This requires Write permission. Se o arquivo já existir, será gerada uma exceção IOException.If the file already exists, an IOException exception is thrown.

Open Open Open Open 3

Especifica que o sistema operacional deve abrir um arquivo existente.Specifies that the operating system should open an existing file. A capacidade de abrir o arquivo depende do valor especificado pela enumeração FileAccess.The ability to open the file is dependent on the value specified by the FileAccess enumeration. Uma exceção FileNotFoundException será gerada se o arquivo não existir.A FileNotFoundException exception is thrown if the file does not exist.

OpenOrCreate OpenOrCreate OpenOrCreate OpenOrCreate 4

Especifica que o sistema operacional deverá abrir um arquivo, se ele existir; caso contrário, um novo arquivo deverá ser criado.Specifies that the operating system should open a file if it exists; otherwise, a new file should be created. Se o arquivo for aberto com FileAccess.Read, a permissão Read será necessária.If the file is opened with FileAccess.Read, Read permission is required. Se o acesso ao arquivo for FileAccess.Write, a permissão Write será necessária.If the file access is FileAccess.Write, Write permission is required. Se o arquivo for aberto com FileAccess.ReadWrite, as permissões Read e Write serão necessárias.If the file is opened with FileAccess.ReadWrite, both Read and Write permissions are required.

Truncate Truncate Truncate Truncate 5

Especifica que o sistema operacional deve abrir um arquivo existente.Specifies that the operating system should open an existing file. Quando o arquivo é aberto, ele deve ser truncado para que seu tamanho seja de zero byte.When the file is opened, it should be truncated so that its size is zero bytes. Isso requer a permissão Write.This requires Write permission. As tentativas de ler de um arquivo aberto com FileMode.Truncate causam uma exceção ArgumentException.Attempts to read from a file opened with FileMode.Truncate cause an ArgumentException exception.

Exemplos

O seguinte FileStream construtor abre um arquivo existente (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)

Comentários

Para obter um exemplo de criação de um arquivo e gravar texto em um arquivo, consulte como: Gravar texto em um arquivo.For an example of creating a file and writing text to a file, see How to: Write Text to a File. Para obter um exemplo de texto de leitura de um arquivo, consulte como: Ler texto de um arquivo.For an example of reading text from a file, see How to: Read Text from a File. Para obter um exemplo de leitura e gravação em um arquivo binário, consulte como: Ler e gravar em um arquivo de dados recém-criado.For an example of reading from and writing to a binary file, see How to: Read and Write to a Newly Created Data File.

Um FileMode parâmetro é especificado em muitos dos construtores para FileStream, IsolatedStorageFileStreame, no Open métodos File e FileInfo para controlar como um arquivo é aberto.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 controle de parâmetros se um arquivo será substituído, criados, abertos, ou uma combinação de ambos.FileMode parameters control whether a file is overwritten, created, opened, or some combination thereof. Use Open para abrir um arquivo existente.Use Open to open an existing file. Para acrescentar a um arquivo, use Append.To append to a file, use Append. Para truncar um arquivo ou criar um arquivo se ele não existir, use Create.To truncate a file or create a file if it doesn't exist, use Create.

Aplica-se a

Veja também