FileMode Enum

Definitie

Naamruimte:
System.IO
Assembly's:
mscorlib.dll, System.IO.FileSystem.Primitives.dll
Assembly:
mscorlib.dll
Assembly:
System.IO.FileSystem.Primitives.dll
Assembly:
netstandard.dll

Hiermee geeft u op hoe het besturingssysteem een bestand moet openen.

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

Velden

Name Waarde Description
CreateNew 1

Hiermee geeft u op dat het besturingssysteem een nieuw bestand moet maken. Hiervoor is toestemming vereist Write . Als het bestand al bestaat, wordt er een IOException uitzondering gegenereerd.
Create 2

Hiermee geeft u op dat het besturingssysteem een nieuw bestand moet maken. Als het bestand al bestaat, wordt het overschreven. Hiervoor is toestemming vereist Write . FileMode.Createis gelijk aan het aanvragen dat als het bestand niet bestaat, gebruiktCreateNew; anders.Truncate Als het bestand al bestaat maar een verborgen bestand is, wordt er een UnauthorizedAccessException uitzondering gegenereerd.
Open 3

Hiermee geeft u op dat het besturingssysteem een bestaand bestand moet openen. De mogelijkheid om het bestand te openen, is afhankelijk van de waarde die is opgegeven door de FileAccess opsomming. Er wordt een FileNotFoundException uitzondering gegenereerd als het bestand niet bestaat.
OpenOrCreate 4

Hiermee geeft u op dat het besturingssysteem een bestand moet openen als het bestaat; anders moet er een nieuw bestand worden gemaakt. Als het bestand wordt geopend met FileAccess.Read, Read is de machtiging vereist. Als de bestandstoegang is FileAccess.Write, Write is de machtiging vereist. Als het bestand wordt geopend met FileAccess.ReadWrite, zijn beide Read en Write machtigingen vereist.
Truncate 5

Hiermee geeft u op dat het besturingssysteem een bestaand bestand moet openen. Wanneer het bestand wordt geopend, moet het worden afgekapt, zodat de grootte nul bytes is. Hiervoor is toestemming vereist Write . Pogingen om te lezen uit een bestand dat is geopend met FileMode.Truncate een uitzondering ArgumentException .
Append 6

Hiermee opent u het bestand als het bestaat en zoekt naar het einde van het bestand of maakt u een nieuw bestand. Hiervoor is toestemming vereist Append . FileMode.Append kan alleen worden gebruikt in combinatie met FileAccess.Write. Als u een positie probeert te zoeken voordat het einde van het bestand een uitzondering genereert IOException , mislukt een poging om te lezen en genereert u een NotSupportedException uitzondering.

Voorbeelden

Met de volgende FileStream constructor wordt een bestaand bestand (FileMode.Open) geopend.

FileStream s2 = new FileStream(name, FileMode.Open, FileAccess.Read, FileShare.Read);

Dim s2 As New FileStream(name, FileMode.Open, FileAccess.Read, FileShare.Read)

Opmerkingen

Zie Instructies voor het schrijven van tekst naar een bestand voor een voorbeeld van het maken van een bestand en het schrijven van tekst naar een bestand. Zie Instructies voor het lezen van tekst uit een bestand voor een voorbeeld van het lezen van tekst uit een bestand. Voor een voorbeeld van het lezen van en schrijven naar een binair bestand, raadpleegt u Instructies: Lezen en schrijven naar een nieuw gemaakt gegevensbestand.

Een FileMode parameter wordt opgegeven in veel van de constructors voor FileStream, IsolatedStorageFileStreamen in de Open methoden van File en FileInfo om te bepalen hoe een bestand wordt geopend.

FileMode parameters bepalen of een bestand wordt overschreven, gemaakt, geopend of een combinatie daarvan. Hiermee Open opent u een bestaand bestand. Als u een bestand wilt toevoegen, gebruikt u Append. Als u een bestand wilt afkappen of een bestand wilt maken als dit niet bestaat, gebruikt u Create.

Van toepassing op

Zie ook