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

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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 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 zum Lesen und Schreiben in eine Binärdatei finden Sie unter How to: Read and Write to a Neu erstellte Datendatei.

Ein FileMode Parameter wird in vielen der Konstruktoren für FileStream IsolatedStorageFileStream, und in den Open Methoden File und FileInfo steuern, wie eine Datei geöffnet wird.

FileMode Parameter steuern, ob eine Datei überschrieben, erstellt, geöffnet oder eine Kombination daraus erstellt wird. Wird verwendet Open , um eine vorhandene Datei zu öffnen. 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: