FileMode Enumeração

Definição

Espaço de Nomes:
System.IO
Assemblagens:
mscorlib.dll, System.IO.FileSystem.Primitives.dll
Assemblagem:
mscorlib.dll
Assemblagem:
System.IO.FileSystem.Primitives.dll
Assemblagem:
netstandard.dll

Especifica como o sistema operativo deve abrir um ficheiro.

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
Object
ValueType
Enum
FileMode
Atributos
SerializableAttribute ComVisibleAttribute

Campos

Name Valor Description
CreateNew 1

Especifica que o sistema operativo deve criar um novo ficheiro. Isto requer Write permissão. Se o ficheiro já existir, é lançada uma IOException exceção.
Create 2

Especifica que o sistema operativo deve criar um novo ficheiro. Se o ficheiro já existir, será sobrescrito. Isto requer Write permissão. FileMode.Create é equivalente a pedir que, se o ficheiro não existir, use CreateNew; caso contrário, use Truncate. Se o ficheiro já existir mas for um ficheiro oculto, é lançada uma UnauthorizedAccessException exceção.
Open 3

Especifica que o sistema operativo deve abrir um ficheiro existente. A capacidade de abrir o ficheiro depende do valor especificado pela FileAccess enumeração. É lançada uma FileNotFoundException exceção se o ficheiro não existir.
OpenOrCreate 4

Especifica que o sistema operativo deve abrir um ficheiro, caso exista; caso contrário, deve ser criado um novo ficheiro. Se o ficheiro for aberto com FileAccess.Read, Read é necessária permissão. Se o acesso ao ficheiro for FileAccess.Write, Write é necessária permissão. Se o ficheiro for aberto com FileAccess.ReadWrite, são necessárias tanto Read permissões como Write .
Truncate 5

Especifica que o sistema operativo deve abrir um ficheiro existente. Quando o ficheiro é aberto, deve ser truncado para que o seu tamanho seja zero bytes. Isto requer Write permissão. Tentativas de ler de um ficheiro aberto causam FileMode.Truncate exceção ArgumentException .
Append 6

Abre o ficheiro se existir e procura o final do ficheiro, ou cria um novo ficheiro. Isto requer Append permissão. FileMode.Append pode ser usado apenas em conjunto com FileAccess.Write. Tentar procurar uma posição antes do fim do ficheiro lança uma IOException exceção, e qualquer tentativa de leitura falha e lança uma NotSupportedException exceção.

Exemplos

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

Observações

Para um exemplo de criação de um ficheiro e escrita de texto para um ficheiro, veja Como: Escrever Texto para um Ficheiro. Para um exemplo de leitura de texto de um ficheiro, veja Como: Ler Texto de um Ficheiro. Para um exemplo de leitura e escrita num ficheiro binário, veja Como: Ler e Escrever num Ficheiro de Dados Recém-Criado.

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

FileMode Os parâmetros controlam se um ficheiro é sobrescrito, criado, aberto ou alguma combinação disso. Use Open para abrir um ficheiro existente. Para anexar a um ficheiro, use Append. Para truncar um ficheiro ou criar um ficheiro se este não existir, use Create.

Aplica-se a

Ver também