Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

FileStream-Konstruktor: (String, FileMode)

 

Veröffentlicht: Oktober 2016

Initialisiert eine neue Instanz der FileStream-Klasse mit dem angegebenen Pfad und dem angegebenen Erstellungsmodus.

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

public FileStream(
	string path,
	FileMode mode
)

Parameter

path
Type: System.String

Ein relativer oder absoluter Pfad zu der Datei, die vom aktuellen FileStream-Objekt gekapselt wird.

mode
Type: System.IO.FileMode

Eine Konstante, die bestimmt, auf welche Weise die Datei geöffnet oder erstellt werden soll.

Exception Condition
ArgumentException

path ist eine leere Zeichenfolge (""), enthält nur Leerzeichen oder enthält mindestens ein ungültiges Zeichen.

- oder -

path verweist auf ein Nicht-Datei-Gerät, etwa "con:", "com1:", "lpt1:" usw., in einer NTFS-Umgebung.

NotSupportedException

path verweist auf ein Nicht-Datei-Gerät, etwa "con:", "com1:", "lpt1:" usw., in einer Nicht-NTFS-Umgebung.

ArgumentNullException

path ist null.

SecurityException

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

FileNotFoundException

Die Datei kann nicht gefunden werden. Dies ist z. B. der Fall, wenn mode auf FileMode.Truncate oder FileMode.Open festgelegt und die durch path angegebene Datei nicht vorhanden ist. Die Datei muss bereits in diesen Modi vorhanden sein.

IOException

Es ist ein E/A-Fehler aufgetreten, beispielsweise weil FileMode.CreateNew angegeben wurde, die durch path angegebene Datei aber bereits vorhanden ist.

- oder -

Der Stream wurde geschlossen.

DirectoryNotFoundException

Der angegebene Pfad ist ungültig, z. B. befindet er sich auf einem nicht zugeordneten Laufwerk.

PathTooLongException

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge. Beispielsweise müssen auf Windows-basierten Plattformen Pfade weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen enthalten.

ArgumentOutOfRangeException

mode enthält einen ungültigen Wert.

.NET Framework unterstützt keine direkten Zugriff auf physische Datenträger über Pfade, die Gerätenamen, z. B. "\\.\PHYSICALDRIVE0" sind.

Die path Parameter kann einen Dateinamen ein, z. B. eine Datei auf einer Freigabe Universal Naming Convention (UNC) sein.

Der Konstruktor erhält Lese-/Schreibzugriff auf die Datei, und es wird geöffnet, und der Lesezugriff freigegeben (also Anforderungen zum Öffnen der Datei für das Schreiben durch diesen oder einen anderen Prozess bis zum Fehlschlagen der FileStream Objekt geschlossen wurde, aber lesen versucht wird erfolgreich ausgeführt werden).

Dieser Konstruktor können Sie um schreibgeschützte Dateien zu öffnen. Stattdessen müssen Sie verwenden, ein Konstruktors, akzeptiert ein FileAccess Parameter mit dem Wert FileAccess.Read.

Die Größe des Puffers wird auf die Standardgröße von 4096 Bytes (4 KB) festgelegt.

System_CAPS_noteHinweis

path ist nicht erforderlich, um eine Datei auf dem Datenträger gespeichert werden. Sie können einen beliebigen Teil eines Systems sein, die Zugriff über Streams unterstützt. Je nach System kann diese Klasse z. B. ein physisches Gerät zugreifen.

CanSeek ist true für alle FileStream Objekte, die Dateien kapseln. Wenn path Gibt an, ein Gerät, das keine Suchvorgänge, unterstützt die CanSeek -Eigenschaft für die resultierende FileStream ist false. Weitere Informationen finden Sie unter CanSeek.

FileShare.Read ist der Standardwert für diese FileStream Konstruktoren ohne eine FileShare Parameter.

Für Konstruktoren ohne eine FileAccess -Parameter, wenn die mode Parameter den Wert Append, Write ist der Standardzugriff. Andernfalls wird der Zugriff auf festgelegt ReadWrite.

System_CAPS_cautionAchtung

Beim Kompilieren einer Reihe von Zeichen mit einer bestimmten kulturellen Einstellung und die gleichen Zeichen mit einer anderen Einstellung für die kulturelle abzurufen, werden die Zeichen möglicherweise nicht interpretiert werden und können dazu führen, dass eine Ausnahme ausgelöst wird.

Eine Liste der häufig verwendeten und Verzeichnisoperationen, finden Sie unter Allgemeine E/A-Aufgaben.

Im folgenden Codebeispiel wird veranschaulicht, wie zum Schreiben von Daten in eine Datei byteweise, und stellen Sie sicher, dass die Daten ordnungsgemäß geschrieben wurden.

using System;
using System.IO;

class FStream
{
    static void Main()
    {
        const string fileName = "Test#@@#.dat";

        // Create random data to write to the file.
        byte[] dataArray = new byte[100000];
        new Random().NextBytes(dataArray);

        using(FileStream  
            fileStream = new FileStream(fileName, FileMode.Create))
        {
            // Write the data to the file, byte by byte.
            for(int i = 0; i < dataArray.Length; i++)
            {
                fileStream.WriteByte(dataArray[i]);
            }

            // Set the stream position to the beginning of the file.
            fileStream.Seek(0, SeekOrigin.Begin);

            // Read and verify the data.
            for(int i = 0; i < fileStream.Length; i++)
            {
                if(dataArray[i] != fileStream.ReadByte())
                {
                    Console.WriteLine("Error writing data.");
                    return;
                }
            }
            Console.WriteLine("The data was written to {0} " +
                "and verified.", fileStream.Name);
        }
    }
}

FileIOPermission

for reading, writing, and appending to files. Associated enumerations: F:System.Security.Permissions.FileIOPermissionAccess.Read, F:System.Security.Permissions.FileIOPermissionAccess.Write, and F:System.Security.Permissions.FileIOPermissionAccess.Append.

Universelle Windows-Plattform
Verfügbar seit 10
.NET Framework
Verfügbar seit 1.1
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0
Zurück zum Anfang
Anzeigen: