FileMode Énumération

Définition

Espace de noms:
System.IO
Assemblys:
mscorlib.dll, System.IO.FileSystem.Primitives.dll
Assembly:
mscorlib.dll
Assembly:
System.IO.FileSystem.Primitives.dll
Assembly:
netstandard.dll

Spécifie comment le système d’exploitation doit ouvrir un fichier.

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
Héritage
Object
ValueType
Enum
FileMode
Attributs
SerializableAttribute ComVisibleAttribute

Champs

Nom Valeur Description
CreateNew 1

Spécifie que le système d’exploitation doit créer un fichier. Cela nécessite Write une autorisation. Si le fichier existe déjà, une IOException exception est levée.
Create 2

Spécifie que le système d’exploitation doit créer un fichier. Si le fichier existe déjà, il sera remplacé. Cela nécessite Write une autorisation. FileMode.Create équivaut à demander que si le fichier n’existe pas, utilisez CreateNew; sinon, utilisez Truncate. Si le fichier existe déjà mais qu’il s’agit d’un fichier masqué, une UnauthorizedAccessException exception est levée.
Open 3

Spécifie que le système d’exploitation doit ouvrir un fichier existant. La possibilité d’ouvrir le fichier dépend de la valeur spécifiée par l’énumération FileAccess . Une FileNotFoundException exception est levée si le fichier n’existe pas.
OpenOrCreate 4

Spécifie que le système d’exploitation doit ouvrir un fichier s’il existe ; sinon, un nouveau fichier doit être créé. Si le fichier est ouvert avec FileAccess.Read, Read l’autorisation est requise. Si l’accès au fichier est FileAccess.Write, Write l’autorisation est requise. Si le fichier est ouvert avec FileAccess.ReadWrite, les deux Read et Write les autorisations sont requises.
Truncate 5

Spécifie que le système d’exploitation doit ouvrir un fichier existant. Lorsque le fichier est ouvert, il doit être tronqué afin que sa taille soit égale à zéro octet. Cela nécessite Write une autorisation. Tente de lire à partir d’un fichier ouvert à FileMode.Truncate l’aide d’une ArgumentException exception.
Append 6

Ouvre le fichier s’il existe et cherche à la fin du fichier, ou crée un fichier. Cela nécessite Append une autorisation. FileMode.Append ne peut être utilisé que conjointement avec FileAccess.Write. Essayer de rechercher une position avant la fin du fichier lève une IOException exception et toute tentative de lecture échoue et lève une NotSupportedException exception.

Exemples

Le constructeur suivant FileStream ouvre un fichier existant (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)

Remarques

Pour obtenir un exemple de création d’un fichier et d’écriture de texte dans un fichier, consultez Guide pratique pour écrire du texte dans un fichier. Pour obtenir un exemple de lecture de texte à partir d’un fichier, consultez Guide pratique pour lire du texte à partir d’un fichier. Pour obtenir un exemple de lecture et d’écriture dans un fichier binaire, consultez Guide pratique pour lire et écrire dans un fichier de données nouvellement créé.

Un FileMode paramètre est spécifié dans la plupart des constructeurs pour FileStream, IsolatedStorageFileStreamet dans les Open méthodes de File et FileInfo pour contrôler l’ouverture d’un fichier.

FileMode les paramètres contrôlent si un fichier est remplacé, créé, ouvert ou une combinaison de celui-ci. Permet Open d’ouvrir un fichier existant. Pour ajouter à un fichier, utilisez Append. Pour tronquer un fichier ou créer un fichier s’il n’existe pas, utilisez Create.

S’applique à

Voir aussi