FileMode-Enumeration

Artikel
08/20/2007

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

Namespace: System.IO
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public Enumeration FileMode
'Usage
Dim instance As FileMode

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public enum FileMode

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public enum class FileMode

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public enum FileMode

SerializableAttribute 
ComVisibleAttribute(true) 
public enum FileMode

Member

	Membername	Beschreibung
	Append	Öffnet die Datei, sofern vorhanden, und sucht bis zum Ende der Datei oder erstellt eine neue Datei. FileMode.Append kann nur gemeinsam mit FileAccess.Write verwendet werden. Leseversuche schlagen fehl und lösen ArgumentException aus.
	Create	Gibt an, dass das Betriebssystem eine neue Datei erstellen soll. Wenn die Datei bereits vorhanden ist, wird diese überschrieben. Dafür ist FileIOPermissionAccess.Write erforderlich. System.IO.FileMode.Create bedeutet, dass CreateNew verwendet wird, wenn die Datei nicht vorhanden ist, und dass andernfalls Truncate verwendet wird.
	CreateNew	Gibt an, dass das Betriebssystem eine neue Datei erstellen soll. Dies erfordert FileIOPermissionAccess.Write. Wenn die Datei bereits vorhanden ist, wird IOException ausgelöst.
	Open	Gibt an, dass das Betriebssystem eine vorhandene Datei öffnen soll. Die Möglichkeit zum Öffnen der Datei hängt vom Wert ab, der von FileAccess angegeben wird. Wenn die Datei nicht vorhanden ist, wird eine System.IO.FileNotFoundException ausgelöst.
	OpenOrCreate	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 FileIOPermissionAccess.Read erforderlich. Wenn der Dateizugriff FileAccess.Write oder FileAccess.ReadWrite ist, ist FileIOPermissionAccess.Write erforderlich. Wenn der Dateizugriff FileAccess.Append ist, ist FileIOPermissionAccess.Append erforderlich.
	Truncate	Gibt an, dass das Betriebssystem eine vorhandene Datei öffnen soll. Nachdem die Datei geöffnet wurde, sollte diese abgeschnitten werden, sodass ihre Größe 0 Bytes beträgt. Dies erfordert FileIOPermissionAccess.Write. Wenn versucht wird, eine mit Truncate geöffnete Datei zu lesen, wird eine Ausnahme ausgelöst.

Hinweise

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

Ein FileMode-Parameter wird in vielen Konstruktoren für FileStream und IsolatedStorageFileStream sowie in den Open-Methoden von File und FileInfo angegeben, um das Öffnen einer Datei zu steuern.

FileMode-Parameter steuern, ob eine Datei überschrieben, erstellt oder geöffnet wird, oder ob mehrere dieser Aktionen erfolgen. Verwenden Sie Open, um eine vorhandene Datei zu öffnen. Verwenden Sie Append, um Daten an eine Datei anzufügen. Verwenden Sie Create, um eine Datei abzuschneiden oder, falls diese nicht vorhanden ist, neu zu erstellen.

Beispiel

Der folgende FileStream-Konstruktor öffnet eine vorhandene Datei (FileMode.Open).

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

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

FileStream^ s2 = gcnew FileStream( name, FileMode::Open, FileAccess::Read, FileShare::Read );

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

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

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

System.IO-Namespace
File.Open
FileInfo.Open
FileStream
IsolatedStorageFileStream

Weitere Ressourcen

Datei- und Stream-E/A
Gewusst wie: Lesen aus einer Textdatei
Gewusst wie: Schreiben von Text in eine Datei
Grundlegende Datei-E/A
Gewusst wie: Lesen und Schreiben einer neu erstellten Datendatei

Freigeben über