FileMode Enumeration

Definition

Gibt an, wie das Betriebssystem eine Datei öffnen soll.Specifies how the operating system should open a file.

public enum class FileMode
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public enum FileMode
type FileMode = 
Public Enum FileMode
Vererbung
FileMode
Attribute

Felder

Append 6

Öffnet die Datei, sofern vorhanden, und sucht bis zum Ende der Datei oder erstellt eine neue Datei.Opens the file if it exists and seeks to the end of the file, or creates a new file. Erfordert die Append-Berechtigung.This requires Append permission. FileMode.Append kann nur gemeinsam mit FileAccess.Write verwendet werden.FileMode.Append can be used only in conjunction with FileAccess.Write. 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.Trying to seek to a position before the end of the file throws an IOException exception, and any attempt to read fails and throws a NotSupportedException exception.

Create 2

Gibt an, dass das Betriebssystem eine neue Datei erstellen soll.Specifies that the operating system should create a new file. Wenn die Datei bereits vorhanden ist, wird diese überschrieben.If the file already exists, it will be overwritten. Erfordert die Write-Berechtigung.This requires Write permission. FileMode.Create entspricht der Anforderung, dass CreateNew verwendet werden soll, wenn die Datei nicht vorhanden ist, und andernfalls Truncate verwendet werden soll.FileMode.Create is equivalent to requesting that if the file does not exist, use CreateNew; otherwise, use Truncate. Wenn die Datei bereits vorhanden ist, aber eine versteckte Datei ist, wird eine UnauthorizedAccessException-Ausnahme ausgelöst.If the file already exists but is a hidden file, an UnauthorizedAccessException exception is thrown.

CreateNew 1

Gibt an, dass das Betriebssystem eine neue Datei erstellen soll.Specifies that the operating system should create a new file. Erfordert die Write-Berechtigung.This requires Write permission. Wenn die Datei bereits vorhanden ist, wird eine IOException-Ausnahme ausgelöst.If the file already exists, an IOException exception is thrown.

Open 3

Gibt an, dass das Betriebssystem eine vorhandene Datei öffnen soll.Specifies that the operating system should open an existing file. Die Möglichkeit, die Datei zu öffnen, hängt von dem Wert ab, der durch die FileAccess-Enumeration angegeben wird.The ability to open the file is dependent on the value specified by the FileAccess enumeration. Eine FileNotFoundException-Ausnahme wird ausgelöst, wenn die Datei nicht vorhanden ist.A FileNotFoundException exception is thrown if the file does not exist.

OpenOrCreate 4

Gibt an, dass das Betriebssystem eine Datei öffnen soll, sofern diese vorhanden ist, oder andernfalls eine neue Datei erstellen soll.Specifies that the operating system should open a file if it exists; otherwise, a new file should be created. Wenn die Datei mit FileAccess.Read geöffnet wird, ist eine Read-Berechtigung erforderlich.If the file is opened with FileAccess.Read, Read permission is required. Wenn der Dateizugriff FileAccess.Write ist, ist Write-Berechtigung erforderlich.If the file access is FileAccess.Write, Write permission is required. Wenn die Datei mit FileAccess.ReadWrite geöffnet wird, sind Read und Write-Berechtigungen erforderlich.If the file is opened with FileAccess.ReadWrite, both Read and Write permissions are required.

Truncate 5

Gibt an, dass das Betriebssystem eine vorhandene Datei öffnen soll.Specifies that the operating system should open an existing file. Wenn die Datei geöffnet wird, sollte sie abgeschnitten werden, sodass ihre Größe 0 Bytes beträgt.When the file is opened, it should be truncated so that its size is zero bytes. Erfordert die Write-Berechtigung.This requires Write permission. Wenn versucht wird, eine mit FileMode.Truncate geöffnete Datei zu lesen, wird eine ArgumentException-Ausnahme ausgelöst.Attempts to read from a file opened with FileMode.Truncate cause an ArgumentException exception.

Beispiele

Der folgende FileStream Konstruktor öffnet eine vorhandene Datei (FileMode.Open).The following FileStream constructor opens an existing file (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 Gewusst wie: Schreiben von Text in eineDatei.For an example of creating a file and writing text to a file, see How to: Write Text to a File. Ein Beispiel für das Lesen von Text aus einer Datei finden Sie unter Gewusst wie: Lesen von Text aus einerDatei.For an example of reading text from a file, see How to: Read Text from a File. 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.For an example of reading from and writing to a binary file, see 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 Methoden von File und Open angegeben, um FileInfo die Art und Weise zu steuern, wie eine Datei geöffnet wird.A FileMode parameter is specified in many of the constructors for FileStream, IsolatedStorageFileStream, and in the Open methods of File and FileInfo to control how a file is opened.

FileModeParameter steuern, ob eine Datei überschrieben, erstellt, geöffnet oder eine Kombination daraus erstellt wird.FileMode parameters control whether a file is overwritten, created, opened, or some combination thereof. Verwenden Open Sie, um eine vorhandene Datei zu öffnen.Use Open to open an existing file. Verwenden AppendSie zum Anfügen an eine Datei.To append to a file, use Append. Um eine Datei abzuschneiden oder eine Datei zu erstellen, falls diese nicht vorhanden ist Create, verwenden Sie.To truncate a file or create a file if it doesn't exist, use Create.

Gilt für:

Siehe auch