FileMode Énumération

Définition

Spécifie la façon dont 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
FileMode
Attributs

Champs

Append 6

Ouvre le fichier s’il existe et accède à la fin du fichier, ou crée un fichier. Cela requiert l’autorisation Append. FileMode.Append peut seulement être utilisé conjointement avec FileAccess.Write. Toute tentative d’effectuer une recherche sur une position avant la fin du fichier lève une exception IOException, et toute tentative de lecture échoue et lève une exception NotSupportedException.

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 requiert l’autorisation Write. FileMode.Create équivaut à demander d’utiliser CreateNew si le fichier n’existe pas ; dans le cas contraire, utilisez Truncate. Si le fichier existe déjà mais qu’il s’agit d’un fichier masqué, une exception UnauthorizedAccessException est levée.

CreateNew 1

Spécifie que le système d’exploitation doit créer un fichier. Cela requiert l’autorisation Write. Si le fichier existe déjà, une exception IOException 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 exception FileNotFoundException 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 fichier doit être créé. Si le fichier est ouvert avec FileAccess.Read, l’autorisation Read est requise. Si l’accès au fichier est FileAccess.Write, l’autorisation Write est requise. Si le fichier est ouvert avec FileAccess.ReadWrite, les autorisations Read et Write sont requises.

Truncate 5

Spécifie que le système d’exploitation doit ouvrir un fichier existant. Quand le fichier est ouvert, il doit être tronqué afin que sa taille soit égale à zéro octet. Cela requiert l’autorisation Write. Toute tentative de lecture d’un fichier ouvert avec FileMode.Truncate entraîne une exception ArgumentException.

Exemples

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

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 méthodes de File et FileInfo pour contrôler la Open façon dont un fichier est ouvert.

FileMode les paramètres déterminent si un fichier est remplacé, créé, ouvert ou une combinaison de ces derniers. Utilisez Open pour 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