FileMode Enumeration

  • Referenz

Definition

Namespace:
System.IO
Assemblys:
mscorlib.dll, System.IO.FileSystem.Primitives.dll
Assembly:
System.Runtime.dll
Assembly:
System.IO.FileSystem.Primitives.dll
Assembly:
mscorlib.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

Append 6

Öffnet die Datei, sofern vorhanden, und sucht bis zum Ende der Datei oder erstellt eine neue Datei. Erfordert die Append-Berechtigung. FileMode.Append kann nur gemeinsam mit FileAccess.Write verwendet werden. Beim Suchen einer Position hinter dem Ende der Datei wird eine IOException-Ausnahme ausgelöst, und sämtliche Leseversuche führen zu Fehlern und lösen eine NotSupportedException-Ausnahme aus.
Create 2

Gibt an, dass das Betriebssystem eine neue Datei erstellen soll. Wenn die Datei bereits vorhanden ist, wird sie überschrieben. Erfordert die Write-Berechtigung. FileMode.Create entspricht der Anforderung, dass CreateNew verwendet werden soll, wenn die Datei nicht vorhanden ist, und andernfalls Truncate verwendet werden soll. Wenn die Datei bereits vorhanden ist, aber eine versteckte Datei ist, wird eine UnauthorizedAccessException-Ausnahme ausgelöst.
CreateNew 1

Gibt an, dass das Betriebssystem eine neue Datei erstellen soll. Erfordert die Write-Berechtigung. Wenn die Datei bereits vorhanden ist, wird eine IOException-Ausnahme ausgelöst.
Open 3

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

Gibt an, dass das Betriebssystem eine Datei öffnen soll, sofern diese vorhanden ist, oder andernfalls eine neue Datei erstellen soll. Wenn die Datei mit FileAccess.Read geöffnet wird, ist eine Read-Berechtigung erforderlich. Wenn der Dateizugriff FileAccess.Write ist, ist Write-Berechtigung erforderlich. Wenn die Datei mit FileAccess.ReadWrite geöffnet wird, sind Read und Write-Berechtigungen erforderlich.
Truncate 5

Gibt an, dass das Betriebssystem eine vorhandene Datei öffnen soll. Wenn die Datei geöffnet wird, sollte sie abgeschnitten werden, sodass ihre Größe 0 Bytes beträgt. Erfordert die Write-Berechtigung. Wenn versucht wird, eine mit FileMode.Truncate geöffnete Datei zu lesen, wird eine ArgumentException-Ausnahme ausgelöst.

Beispiele

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

Hinweise

Ein Beispiel für das Erstellen einer Datei und das Schreiben von Text in eine Datei finden Sie unter Vorgehensweise: Schreiben von Text in eine Datei. Ein Beispiel für das Lesen von Text aus einer Datei finden Sie unter Vorgehensweise: Lesen von Text aus einer Datei. Ein Beispiel für das Lesen aus einer Binärdatei und das Schreiben in eine Binärdatei finden Sie unter Vorgehensweise: Lesen und Schreiben in eine neu erstellte Datendatei.

Ein FileMode Parameter wird in vielen Konstruktoren für FileStream, IsolatedStorageFileStreamund in den Open Methoden von File und FileInfo angegeben, um zu steuern, wie eine Datei geöffnet wird.

FileMode Parameter steuern, ob eine Datei überschrieben, erstellt, geöffnet oder eine Kombination davon erstellt wird. Verwenden Sie Open , um eine vorhandene Datei zu öffnen. Verwenden Sie Appendzum Anfügen an eine Datei . Verwenden Sie Create, um eine Datei abzuschneiden oder eine Datei zu erstellen, wenn sie nicht vorhanden ist.

Gilt für:

Weitere Informationen