Partilhar via


FileMode Enumeração

Definição

Especifica como o sistema operacional deve abrir um arquivo.

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
Herança
FileMode
Atributos

Campos

Append 6

Abre o arquivo, caso ele exista, e busca o final do arquivo ou cria um novo arquivo. Isso requer a permissão Append. FileMode.Append pode ser usado apenas em conjunto com 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.

Create 2

Especifica que o sistema operacional deve criar um novo arquivo. Se o arquivo já existir, ele será substituído. Isso requer a permissão Write. FileMode.Create é equivalente a solicitar que, se o arquivo não existir, CreateNew seja usado; caso contrário, Truncate deverá ser usado. Se o arquivo já existir, mas for um arquivo oculto, será gerada uma exceção UnauthorizedAccessException.

CreateNew 1

Especifica que o sistema operacional deve criar um novo arquivo. Isso requer a permissão Write. Se o arquivo já existir, será gerada uma exceção IOException.

Open 3

Especifica que o sistema operacional deve abrir um arquivo existente. A capacidade de abrir o arquivo depende do valor especificado pela enumeração FileAccess. Uma exceção FileNotFoundException será gerada se o arquivo não existir.

OpenOrCreate 4

Especifica que o sistema operacional deverá abrir um arquivo, se ele existir; caso contrário, um novo arquivo deverá ser criado. Se o arquivo for aberto com FileAccess.Read, a permissão Read será necessária. Se o acesso ao arquivo for FileAccess.Write, a permissão Write será necessária. Se o arquivo for aberto com FileAccess.ReadWrite, as permissões Read e Write serão necessárias.

Truncate 5

Especifica que o sistema operacional deve abrir um arquivo existente. Quando o arquivo é aberto, ele deve ser truncado para que seu tamanho seja de zero byte. Isso requer a permissão Write. As tentativas de ler de um arquivo aberto com FileMode.Truncate causam uma exceção ArgumentException.

Exemplos

FileStream O construtor a seguir abre um arquivo existente (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 como criar um arquivo e gravar texto em um arquivo, consulte Como gravar texto em um arquivo. Para obter um exemplo de leitura de texto de um arquivo, consulte Como ler texto de um arquivo. 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.

Um FileMode parâmetro é especificado em muitos dos construtores para FileStream, IsolatedStorageFileStreame nos Open métodos de File e FileInfo para controlar como um arquivo é aberto.

FileMode os parâmetros controlam se um arquivo é substituído, criado, aberto ou alguma combinação dele. Use Open para abrir um arquivo existente. Para acrescentar a um arquivo, use Append. Para truncar um arquivo ou criar um arquivo se ele não existir, use Create.

Aplica-se a

Confira também