FileMode Énumération

Définition

Spécifie la façon dont le système d'exploitation doit ouvrir un fichier.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
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.Opens the file if it exists and seeks to the end of the file, or creates a new file. Cela requiert l’autorisation Append.This requires Append permission. FileMode.Append peut seulement être utilisé conjointement avec FileAccess.Write.FileMode.Append can be used only in conjunction with 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.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 2

Spécifie que le système d’exploitation doit créer un fichier.Specifies that the operating system should create a new file. Si le fichier existe, il est remplacé.If the file already exists, it will be overwritten. Cela requiert l’autorisation Write.This requires Write permission. FileMode.Create équivaut à demander d’utiliser CreateNew si le fichier n’existe pas ; dans le cas contraire, utilisez Truncate.FileMode.Create is equivalent to requesting that if the file does not exist, use CreateNew; otherwise, use Truncate. Si le fichier existe déjà mais qu’il s’agit d’un fichier masqué, une exception UnauthorizedAccessException est levée.If the file already exists but is a hidden file, an UnauthorizedAccessException exception is thrown.

CreateNew 1

Spécifie que le système d’exploitation doit créer un fichier.Specifies that the operating system should create a new file. Cela requiert l’autorisation Write.This requires Write permission. Si le fichier existe déjà, une exception IOException est levée.If the file already exists, an IOException exception is thrown.

Open 3

Spécifie que le système d’exploitation doit ouvrir un fichier existant.Specifies that the operating system should open an existing file. La possibilité d’ouvrir le fichier dépend de la valeur spécifiée par l’énumération FileAccess.The ability to open the file is dependent on the value specified by the FileAccess enumeration. Une exception FileNotFoundException est levée si le fichier n’existe pas.A FileNotFoundException exception is thrown if the file does not exist.

OpenOrCreate 4

Spécifie que le système d’exploitation doit ouvrir un fichier s’il existe ; sinon, un fichier doit être créé.Specifies that the operating system should open a file if it exists; otherwise, a new file should be created. Si le fichier est ouvert avec FileAccess.Read, l’autorisation Read est requise.If the file is opened with FileAccess.Read, Read permission is required. Si l’accès au fichier est FileAccess.Write, l’autorisation Write est requise.If the file access is FileAccess.Write, Write permission is required. Si le fichier est ouvert avec FileAccess.ReadWrite, les autorisations Read et Write sont requises.If the file is opened with FileAccess.ReadWrite, both Read and Write permissions are required.

Truncate 5

Spécifie que le système d’exploitation doit ouvrir un fichier existant.Specifies that the operating system should open an existing file. Quand le fichier est ouvert, il doit être tronqué afin que sa taille soit égale à zéro octet.When the file is opened, it should be truncated so that its size is zero bytes. Cela requiert l’autorisation Write.This requires Write permission. Toute tentative de lecture d’un fichier ouvert avec FileMode.Truncate entraîne une exception ArgumentException.Attempts to read from a file opened with FileMode.Truncate cause an ArgumentException exception.

Exemples

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

Remarques

Pour obtenir un exemple de création d’un fichier et d’écriture de texte dans un fichier, consultez Procédure: Écrire du texte dans unfichier.For an example of creating a file and writing text to a file, see How to: Write Text to a File. Pour obtenir un exemple de lecture de texte à partir d' un fichier, consultez Procédure: Lire du texte à partird’un fichier.For an example of reading text from a file, see How to: Read Text from a File. Pour obtenir un exemple de lecture et d’écriture dans un fichier binaire, consultez Procédure: Lire et écrire dans un fichierde données nouvellement créé.For an example of reading from and writing to a binary file, see How to: Read and Write to a Newly Created Data File.

Un FileMode paramètre est spécifié dans de nombreux constructeurs pour FileStream, IsolatedStorageFileStreamet dans les Open méthodes de File et FileInfo pour contrôler la façon dont un fichier est ouvert.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.

FileModeles paramètres contrôlent si un fichier est remplacé, créé, ouvert ou une combinaison de ces derniers.FileMode parameters control whether a file is overwritten, created, opened, or some combination thereof. Utilisez Open pour ouvrir un fichier existant.Use Open to open an existing file. Pour ajouter à un fichier, utilisez Append.To append to a file, use Append. Pour tronquer un fichier ou créer un fichier s’il n’existe pas, Createutilisez.To truncate a file or create a file if it doesn't exist, use Create.

S’applique à

Voir aussi