FileMode FileMode FileMode FileMode Enum

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
Attribute

Felder

Append Append Append 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 Create Create 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 CreateNew CreateNew 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 Open Open 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 OpenOrCreate OpenOrCreate 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 Truncate Truncate 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

Die folgenden 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 eine Datei erstellen und Schreiben von Text in eine Datei, finden Sie unter Vorgehensweise: Schreiben von Text in eine Datei.For an example of creating a file and writing text to a file, see How to: Write Text to a File. Ein Beispiel Lesen von Text aus einer Datei finden Sie unter Vorgehensweise: Lesen von Text aus einer Datei.For an example of reading text from a file, see How to: Read Text from a File. Ein Beispiel für das Lesen und Schreiben in eine Binärdatei, finden Sie unter Vorgehensweise: Lesen und Schreiben in 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 angegeben, in vielen der Konstruktoren für FileStream, IsolatedStorageFileStream, und klicken Sie in der Open Methoden File und FileInfo steuern, wie eine Datei geöffnet ist.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.

FileMode Parameter-Steuerelement, ob eine Datei erstellt, überschrieben wird, geöffnet, oder einer Kombination daraus entgegennehmen.FileMode parameters control whether a file is overwritten, created, opened, or some combination thereof. Verwendung Open um eine vorhandene Datei zu öffnen.Use Open to open an existing file. Verwenden Sie zum Anfügen an eine Datei Append.To append to a file, use Append. Um eine Datei Abschneiden oder erstellen Sie eine Datei aus, wenn er nicht vorhanden ist, verwenden Sie Create.To truncate a file or create a file if it doesn't exist, use Create.

Gilt für:

Siehe auch