FileMode Enumeration

Definition

Namespace:
System.IO
Assemblys:
mscorlib.dll, System.IO.FileSystem.Primitives.dll
Assembly:
mscorlib.dll
Assembly:
System.IO.FileSystem.Primitives.dll
Assembly:
netstandard.dll

Gibt an, wie das Betriebssystem eine Datei öffnen soll.

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

Felder

Name Wert Beschreibung
CreateNew 1

Gibt an, dass das Betriebssystem eine neue Datei erstellen soll. Dies erfordert Write die Berechtigung. Wenn die Datei bereits vorhanden ist, wird eine IOException Ausnahme ausgelöst.
Create 2

Gibt an, dass das Betriebssystem eine neue Datei erstellen soll. Wenn die Datei bereits vorhanden ist, wird sie überschrieben. Dies erfordert Write die Berechtigung. FileMode.Create entspricht der Anforderung, dass, wenn die Datei nicht vorhanden ist, verwenden CreateNew; andernfalls verwenden Truncate. Wenn die Datei bereits vorhanden ist, aber eine ausgeblendete Datei ist, wird eine UnauthorizedAccessException Ausnahme ausgelöst.
Open 3

Gibt an, dass das Betriebssystem eine vorhandene Datei öffnen soll. Die Möglichkeit zum Öffnen der Datei hängt von dem von der FileAccess Enumeration angegebenen Wert ab. Eine FileNotFoundException Ausnahme wird ausgelöst, wenn die Datei nicht vorhanden ist.
OpenOrCreate 4

Gibt an, dass das Betriebssystem eine Datei öffnen soll, falls vorhanden; andernfalls sollte eine neue Datei erstellt werden. Wenn die Datei mit FileAccess.Readgeöffnet wird, Read ist die Berechtigung erforderlich. Wenn der Dateizugriff lautet FileAccess.Write, Write ist die Berechtigung erforderlich. Wenn die Datei mit FileAccess.ReadWrite, und Write Berechtigungen geöffnet wird, sind beide Read erforderlich.
Truncate 5

Gibt an, dass das Betriebssystem eine vorhandene Datei öffnen soll. Wenn die Datei geöffnet wird, sollte sie abgeschnitten werden, damit ihre Größe null Bytes ist. Dies erfordert Write die Berechtigung. Versucht, aus einer datei zu lesen, die mit FileMode.Truncate einer ArgumentException Ausnahme geöffnet wurde.
Append 6

Öffnet die Datei, wenn sie vorhanden ist, und sucht nach dem Ende der Datei, oder erstellt eine neue Datei. Dies erfordert Append die Berechtigung. FileMode.Append kann nur in Verbindung mit FileAccess.Write. Beim Versuch, eine Position vor dem Ende der Datei zu suchen, wird eine IOException Ausnahme ausgelöst, und jeder Versuch, zu lesen, schlägt fehl und löst eine NotSupportedException Ausnahme aus.

Beispiele

Der folgende FileStream Konstruktor öffnet eine vorhandene Datei (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)

Hinweise

Ein Beispiel für das Erstellen einer Datei und das Schreiben von Text in eine Datei finden Sie unter How to: Write Text to a File. Ein Beispiel zum Lesen von Text aus einer Datei finden Sie unter How to: Read Text from a File. Ein Beispiel für das Lesen und Schreiben in eine Binärdatei finden Sie unter How to: Read and Write to a Newly Created Data File.

Ein FileMode Parameter wird in vielen der Konstruktoren für FileStream, IsolatedStorageFileStreamund in den Open Methoden und File zur Steuerung der Art und FileInfo Weise angegeben, wie eine Datei geöffnet wird.

FileMode Parameter steuern, ob eine Datei überschrieben, erstellt, geöffnet oder eine Kombination davon verwendet wird. Dient Open zum Öffnen einer vorhandenen Datei. Verwenden Sie Appendzum Anfügen an eine Datei . Wenn Sie eine Datei abschneiden oder eine Datei erstellen möchten, wenn sie nicht vorhanden ist, verwenden Sie Create.

Gilt für:

Weitere Informationen