FileStream Konstruktoren

Referenz

Definition

Namespace:: System.IO

Assemblys:: mscorlib.dll, System.IO.FileSystem.dll

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Assembly:: System.IO.FileSystem.dll

Assembly:: mscorlib.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.

Initialisiert eine neue Instanz der FileStream-Klasse.

Überlädt

FileStream(SafeFileHandle, FileAccess)	Initialisiert eine neue Instanz der FileStream-Klasse für das angegebene Dateihandle und mit der angegebenen Lese- und Schreibberechtigung.
FileStream(String, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity)	Initialisiert eine neue Instanz der FileStream-Klasse mit den Angaben für den Pfad, den Erstellungsmodus, die Zugriffsrechte und die Freigabeberechtigung, die Puffergröße, zusätzliche Dateioptionen, die Zugriffssteuerung und die Überwachungssicherheit.
FileStream(String, FileMode, FileSystemRights, FileShare, Int32, FileOptions)	Initialisiert eine neue Instanz der FileStream-Klasse mit den Angaben für den Pfad, den Erstellungsmodus, die Zugriffsrechte und die Freigabeberechtigung, die Puffergröße und zusätzliche Dateioptionen.
FileStream(String, FileMode, FileAccess, FileShare, Int32, FileOptions)	Initialisiert eine neue Instanz der FileStream-Klasse mit den Angaben für den Pfad, den Erstellungsmodus, die Lese-/Schreib- und Freigabeberechtigung, die Zugriffsmöglichkeiten anderer FileStreams auf die gleiche Datei, die Puffergröße und zusätzliche Dateioptionen.
FileStream(String, FileMode, FileAccess, FileShare, Int32)	Initialisiert eine neue Instanz der FileStream-Klasse mit den Angaben für den Pfad, den Erstellungsmodus, die Lese-/Schreib- und Freigabeberechtigung sowie die Puffergröße.
FileStream(IntPtr, FileAccess, Boolean, Int32, Boolean)	Veraltet. Veraltet. Veraltet. Veraltet. Initialisiert eine neue Instanz der FileStream-Klasse für das angegebene Dateihandle mit den Angaben für die Lese-/Schreibberechtigung, den Besitz der `FileStream`-Instanz, die Puffergröße und den synchronen bzw. asynchronen Zustand.
FileStream(String, FileMode, FileAccess, FileShare)	Initialisiert eine neue Instanz der FileStream-Klasse mit den Angaben für den Pfad, den Erstellungsmodus, die Lese-/Schreib- und Freigabeberechtigung.
FileStream(IntPtr, FileAccess, Boolean, Int32)	Veraltet. Veraltet. Veraltet. Veraltet. Initialisiert eine neue Instanz der FileStream-Klasse für das angegebene Dateihandle mit den Angaben für die Lese-/Schreibberechtigung, den Besitz der `FileStream`-Instanz und die Puffergröße.
FileStream(String, FileMode, FileAccess, FileShare, Int32, Boolean)	Initialisiert eine neue Instanz der FileStream-Klasse mit den Angaben für den Pfad, den Erstellungsmodus, die Lese-/Schreib- und Freigabeberechtigung, die Puffergröße und den synchronen bzw. asynchronen Zustand.
FileStream(String, FileMode, FileAccess)	Initialisiert eine neue Instanz der FileStream-Klasse mit den Angaben für den Pfad, den Erstellungsmodus und die Lese-/Schreibberechtigung.
FileStream(IntPtr, FileAccess, Boolean)	Veraltet. Veraltet. Veraltet. Veraltet. Initialisiert eine neue Instanz der FileStream-Klasse für das angegebene Dateihandle mit den Angaben für die Lese-/Schreibberechtigung und für den Besitz der `FileStream`-Instanz.
FileStream(SafeFileHandle, FileAccess, Int32)	Initialisiert eine neue Instanz der FileStream-Klasse für das angegebene Dateihandle mit den Angaben für die Lese-/Schreibberechtigung und die Puffergröße.
FileStream(SafeFileHandle, FileAccess, Int32, Boolean)	Initialisiert eine neue Instanz der FileStream-Klasse für das angegebene Dateihandle mit den Angaben für die Lese-/Schreibberechtigung, die Puffergröße und den synchronen bzw. asynchronen Zustand.
FileStream(String, FileStreamOptions)	Initialisiert eine neue Instanz der FileStream -Klasse mit dem angegebenen Pfad, dem angegebenen Erstellungsmodus, der Lese-/Schreib- und Freigabeberechtigung, der Puffergröße, zusätzlichen Dateioptionen, der Vorabzuordnungsgröße und dem Zugriff, den andere FileStreams auf dieselbe Datei haben können.
FileStream(String, FileMode)	Initialisiert eine neue Instanz der FileStream-Klasse mit dem angegebenen Pfad und dem angegebenen Erstellungsmodus.
FileStream(IntPtr, FileAccess)	Veraltet. Veraltet. Veraltet. Veraltet. Initialisiert eine neue Instanz der FileStream-Klasse für das angegebene Dateihandle und mit der angegebenen Lese- und Schreibberechtigung.

FileStream(SafeFileHandle, FileAccess)

Initialisiert eine neue Instanz der FileStream-Klasse für das angegebene Dateihandle und mit der angegebenen Lese- und Schreibberechtigung.

public:
 FileStream(Microsoft::Win32::SafeHandles::SafeFileHandle ^ handle, System::IO::FileAccess access);

public FileStream (Microsoft.Win32.SafeHandles.SafeFileHandle handle, System.IO.FileAccess access);

new System.IO.FileStream : Microsoft.Win32.SafeHandles.SafeFileHandle * System.IO.FileAccess -> System.IO.FileStream

Public Sub New (handle As SafeFileHandle, access As FileAccess)

Parameter

handle: SafeFileHandle

Ein Dateihandle für die Datei, die vom aktuellen FileStream-Objekt gekapselt wird.

access: FileAccess

Eine bitweise Kombination der Enumerationswerte, die die Eigenschaften CanRead und CanWrite des FileStream-Objekts festlegen.

Ausnahmen

ArgumentException

access ist kein Feld von FileAccess.

SecurityException

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

IOException

Ein E/A-Fehler, z. B. ein Datenträgerfehler, ist aufgetreten.

- oder -

Der Stream wurde geschlossen.

UnauthorizedAccessException

Der angeforderte access für das angegebene Dateihandle wird vom Betriebssystem nicht zugelassen. Dies ist z. B. der Fall, wenn access auf Write oder ReadWrite festgelegt und das Dateihandle schreibgeschützt ist.

Hinweise

Wenn Close aufgerufen wird, wird das Handle ebenfalls geschlossen, und die Handleanzahl der Datei wird dekrementiert.

FileStream geht davon aus, dass es über die exklusive Kontrolle über das Handle verfügt. Das Lesen, Schreiben oder Suchen, während ein FileStream ebenfalls ein Handle hält, kann zu Datenbeschädigungen führen. Rufen Sie aus Gründen der Datensicherheit Flush auf, bevor Sie das Handle verwenden, und vermeiden Sie das Aufrufen anderer Methoden als Close nach der Verwendung des Handles.

Achtung

Wenn Sie einen Satz von Zeichen mit einer bestimmten Kultureinstellung kompilieren und dieselben Zeichen mit einer anderen Kultureinstellung abrufen, sind die Zeichen möglicherweise nicht interpretierbar und können dazu führen, dass eine Ausnahme ausgelöst wird.

FileShare.Read ist die Standardeinstellung für diese FileStream Konstruktoren ohne FileShare Parameter.

Eine Liste der allgemeinen Datei- und Verzeichnisvorgänge finden Sie unter Allgemeine E/A-Aufgaben.

Siehe auch

Gilt für:

FileStream(String, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity)

Initialisiert eine neue Instanz der FileStream-Klasse mit den Angaben für den Pfad, den Erstellungsmodus, die Zugriffsrechte und die Freigabeberechtigung, die Puffergröße, zusätzliche Dateioptionen, die Zugriffssteuerung und die Überwachungssicherheit.

public:
 FileStream(System::String ^ path, System::IO::FileMode mode, System::Security::AccessControl::FileSystemRights rights, System::IO::FileShare share, int bufferSize, System::IO::FileOptions options, System::Security::AccessControl::FileSecurity ^ fileSecurity);

public FileStream (string path, System.IO.FileMode mode, System.Security.AccessControl.FileSystemRights rights, System.IO.FileShare share, int bufferSize, System.IO.FileOptions options, System.Security.AccessControl.FileSecurity fileSecurity);

new System.IO.FileStream : string * System.IO.FileMode * System.Security.AccessControl.FileSystemRights * System.IO.FileShare * int * System.IO.FileOptions * System.Security.AccessControl.FileSecurity -> System.IO.FileStream

Public Sub New (path As String, mode As FileMode, rights As FileSystemRights, share As FileShare, bufferSize As Integer, options As FileOptions, fileSecurity As FileSecurity)

Parameter

path: String

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

mode: FileMode

Einer der Enumerationswerte, der bestimmt, wie die Datei geöffnet oder erstellt wird.

rights: FileSystemRights

Eine bitweise Kombination der Enumerationswerte, die die beim Erstellen der Zugriffs- und Überwachungsregeln für die Datei zu verwendenden Zugriffsrechte festlegt.

share: FileShare

Eine bitweise Kombination der Enumerationswerte, die bestimmt, wie die Datei von Prozessen gemeinsam verwendet wird.

bufferSize: Int32

Ein positiver Int32-Wert größer als 0 (null), der die Puffergröße angibt. Die Standardpuffergröße ist 4096.

options: FileOptions

Eine bitweise Kombination der Enumerationswerte, die zusätzliche Dateioptionen angibt.

fileSecurity: FileSecurity

Ein Objekt, das die Zugriffssteuerung und die Überwachungssicherheit für die Datei bestimmt.

Ausnahmen

ArgumentNullException

path ist null.

ArgumentException

.NET Framework und .NET Core-Versionen vor 2.1: ist eine leere Zeichenfolge (""), enthält nur Leerzeichen oder mindestens ein path 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.

ArgumentOutOfRangeException

bufferSize ist negativ oder 0 (null).

- oder - mode, access oder share enthält einen ungültigen Wert.

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.

SecurityException

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

DirectoryNotFoundException

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

UnauthorizedAccessException

Der angeforderte access für den angegebenen path wird vom Betriebssystem nicht zugelassen. Dies ist z. B. der Fall, wenn access auf Write oder ReadWrite festgelegt und die Datei bzw. das Verzeichnis schreibgeschützt ist.

- oder - Encrypted ist für options angegeben, aber Dateiverschlüsselung wird auf der aktuellen Plattform nicht unterstützt.

PathTooLongException

Der angegebene path und/oder der angegebene Dateiname überschreiten die vom System definierte maximale Länge.

PlatformNotSupportedException

Das aktuelle Betriebssystem ist nicht Windows NT oder höher.

Beispiele

Im folgenden Beispiel werden Daten in eine Datei schreibt und dann mithilfe des -Objekts FileStream gelesen.

using namespace System;
using namespace System::IO;
using namespace System::Text;
using namespace System::Security::AccessControl;
using namespace System::Security::Principal;

int main()
{
    try
    {
        // Create a file and write data to it.

        // Create an array of bytes.
        array<Byte>^ messageByte =
            Encoding::ASCII->GetBytes("Here is some data.");

        // Specify an access control list (ACL)
        FileSecurity^ fs = gcnew FileSecurity();

        fs->AddAccessRule(
            gcnew FileSystemAccessRule("MYDOMAIN\\MyAccount",
            FileSystemRights::Modify, AccessControlType::Allow));

        // Create a file using the FileStream class.
        FileStream^ fWrite = gcnew FileStream("test.txt",
            FileMode::Create, FileSystemRights::Modify,
            FileShare::None, 8, FileOptions::None, fs);

        // Write the number of bytes to the file.
        fWrite->WriteByte((Byte)messageByte->Length);

        // Write the bytes to the file.
        fWrite->Write(messageByte, 0, messageByte->Length);

        // Close the stream.
        fWrite->Close();

        // Open a file and read the number of bytes.

        FileStream^ fRead = 
            gcnew FileStream("test.txt", FileMode::Open);

        // The first byte is the string length.
        int length = (int)fRead->ReadByte();

        // Create a new byte array for the data.
        array<Byte>^ readBytes = gcnew array<Byte>(length);

        // Read the data from the file.
        fRead->Read(readBytes, 0, readBytes->Length);

        // Close the stream.
        fRead->Close();

        // Display the data.
        Console::WriteLine(Encoding::ASCII->GetString(readBytes));

        Console::WriteLine("Done writing and reading data.");
    }

    catch (IdentityNotMappedException^)
    {
        Console::WriteLine("You need to use your own credentials " +
            " 'MYDOMAIN\\MyAccount'.");
    }

    catch (IOException^ ex)
    {
        Console::WriteLine(ex->Message);
    }
}

using System;
using System.IO;
using System.Text;
using System.Security.AccessControl;

namespace FileSystemExample
{
    class FileStreamExample
    {
        public static void Main()
        {
            try
            {
                // Create a file and write data to it.

                // Create an array of bytes.
                byte[] messageByte = Encoding.ASCII.GetBytes("Here is some data.");

                // Specify an access control list (ACL)
                FileSecurity fs = new FileSecurity();

                fs.AddAccessRule(new FileSystemAccessRule(@"DOMAINNAME\AccountName",
                                                            FileSystemRights.ReadData,
                                                            AccessControlType.Allow));

                // Create a file using the FileStream class.
                FileStream fWrite = new FileStream("test.txt", FileMode.Create, FileSystemRights.Modify, FileShare.None, 8, FileOptions.None, fs);

                // Write the number of bytes to the file.
                fWrite.WriteByte((byte)messageByte.Length);

                // Write the bytes to the file.
                fWrite.Write(messageByte, 0, messageByte.Length);

                // Close the stream.
                fWrite.Close();

                // Open a file and read the number of bytes.

                FileStream fRead = new FileStream("test.txt", FileMode.Open);

                // The first byte is the string length.
                int length = (int)fRead.ReadByte();

                // Create a new byte array for the data.
                byte[] readBytes = new byte[length];

                // Read the data from the file.
                fRead.Read(readBytes, 0, readBytes.Length);

                // Close the stream.
                fRead.Close();

                // Display the data.
                Console.WriteLine(Encoding.ASCII.GetString(readBytes));

                Console.WriteLine("Done writing and reading data.");
            }
            catch (Exception e)
            {
                Console.WriteLine(e);
            }

            Console.ReadLine();
        }
    }
}

Imports System.IO
Imports System.Text
Imports System.Security.AccessControl



Module FileStreamExample

    Sub Main()
        Try
            ' Create a file and write data to it.
            ' Create an array of bytes.
            Dim messageByte As Byte() = Encoding.ASCII.GetBytes("Here is some data.")

            ' Specify an access control list (ACL)
            Dim fs As New FileSecurity()

            fs.AddAccessRule(New FileSystemAccessRule("DOMAINNAME\AccountName", FileSystemRights.ReadData, AccessControlType.Allow))

            ' Create a file using the FileStream class.
            Dim fWrite As New FileStream("test.txt", FileMode.Create, FileSystemRights.Modify, FileShare.None, 8, FileOptions.None, fs)

            ' Write the number of bytes to the file.
            fWrite.WriteByte(System.Convert.ToByte(messageByte.Length))

            ' Write the bytes to the file.
            fWrite.Write(messageByte, 0, messageByte.Length)

            ' Close the stream.
            fWrite.Close()


            ' Open a file and read the number of bytes.
            Dim fRead As New FileStream("test.txt", FileMode.Open)

            ' The first byte is the string length.
            Dim length As Integer = Fix(fRead.ReadByte())

            ' Create a new byte array for the data.
            Dim readBytes(length) As Byte

            ' Read the data from the file.
            fRead.Read(readBytes, 0, readBytes.Length)

            ' Close the stream.
            fRead.Close()

            ' Display the data.
            Console.WriteLine(Encoding.ASCII.GetString(readBytes))

            Console.WriteLine("Done writing and reading data.")
        Catch e As Exception
            Console.WriteLine(e)
        End Try

        Console.ReadLine()

    End Sub
End Module

Hinweise

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

Verwenden Sie FileStream diesen Konstruktor, um zugriffsrechte zum Zeitpunkt der Erstellung einer Datei anzuwenden. Um auf Rechte für eine vorhandene Datei zu zugreifen oder sie zu ändern, sollten Sie die Methoden GetAccessControl und SetAccessControl verwenden.

Der fileOptions -Parameter wird verwendet, um Zugriff auf erweiterte Vorgänge zu ermöglichen, die beim Erstellen eines -Objekts genutzt werden FileStream können.

Der path Parameter kann ein Dateiname sein, einschließlich einer Datei auf einer Universal Naming Convention(UNC)-Freigabe.

Hinweis

path muss keine Datei sein, die auf dem Datenträger gespeichert ist. es kann ein beliebiger Teil eines Systems sein, das den Zugriff über Streams unterstützt. Je nach System kann diese Klasse beispielsweise auf ein physisches Gerät zugreifen.

CanSeek ist true für alle FileStream Objekte, die Dateien kapseln. Wenn path ein Gerät angibt, das such nicht unterstützt, ist CanSeek die -Eigenschaft auf dem FileStream resultierenden false . Weitere Informationen finden Sie unter CanSeek.

Achtung

Eine Liste der allgemeinen Datei- und Verzeichnisvorgänge finden Sie unter Allgemeine E/A-Aufgaben.

Wichtig

Dieser Konstruktor ist in .NET Core nicht vorhanden. Stattdessen können Sie ab .NET Core 3.1 die folgende Erweiterungsmethode der -Klasse FileSystemAclExtensions innerhalb der Assembly System.Security.AccessControl verwenden: Create(FileInfo, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity) .

Siehe auch

Gilt für:

FileStream(String, FileMode, FileSystemRights, FileShare, Int32, FileOptions)

public:
 FileStream(System::String ^ path, System::IO::FileMode mode, System::Security::AccessControl::FileSystemRights rights, System::IO::FileShare share, int bufferSize, System::IO::FileOptions options);

public FileStream (string path, System.IO.FileMode mode, System.Security.AccessControl.FileSystemRights rights, System.IO.FileShare share, int bufferSize, System.IO.FileOptions options);

new System.IO.FileStream : string * System.IO.FileMode * System.Security.AccessControl.FileSystemRights * System.IO.FileShare * int * System.IO.FileOptions -> System.IO.FileStream

Public Sub New (path As String, mode As FileMode, rights As FileSystemRights, share As FileShare, bufferSize As Integer, options As FileOptions)

Parameter

path: String

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

mode: FileMode

Einer der Enumerationswerte, der bestimmt, wie die Datei geöffnet oder erstellt wird.

rights: FileSystemRights

Eine bitweise Kombination der Enumerationswerte, die die beim Erstellen der Zugriffs- und Überwachungsregeln für die Datei zu verwendenden Zugriffsrechte festlegt.

share: FileShare

Eine bitweise Kombination der Enumerationswerte, die bestimmt, wie die Datei von Prozessen gemeinsam verwendet wird.

bufferSize: Int32

Ein positiver Int32-Wert größer als 0 (null), der die Puffergröße angibt. Die Standardpuffergröße ist 4096.

options: FileOptions

Eine bitweise Kombination der Enumerationswerte, die zusätzliche Dateioptionen angibt.

Ausnahmen

ArgumentNullException

path ist null.

ArgumentException

.NET Framework und .NET Core-Versionen vor 2.1: ist eine leere Zeichenfolge (""), enthält nur Leerzeichen oder mindestens ein path 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.

ArgumentOutOfRangeException

bufferSize ist negativ oder 0 (null).

- oder - mode, access oder share enthält einen ungültigen Wert.

FileNotFoundException

PlatformNotSupportedException

Das aktuelle Betriebssystem ist nicht Windows NT oder höher.

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.

SecurityException

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

DirectoryNotFoundException

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

UnauthorizedAccessException

- oder - Encrypted ist für options angegeben, aber Dateiverschlüsselung wird auf der aktuellen Plattform nicht unterstützt.

PathTooLongException

Der angegebene path und/oder der angegebene Dateiname überschreiten die vom System definierte maximale Länge.

Hinweise

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

Der fileOptions -Parameter wird verwendet, um Zugriff auf erweiterte Vorgänge zu ermöglichen, die beim Erstellen eines -Objekts genutzt werden FileStream können.

Der path -Parameter kann ein Dateiname sein, einschließlich einer Datei auf einer Universal Naming Convention(UNC)-Freigabe.

Hinweis

Achtung

Eine Liste der allgemeinen Datei- und Verzeichnisvorgänge finden Sie unter Allgemeine E/A-Aufgaben.

Siehe auch

Gilt für:

FileStream(String, FileMode, FileAccess, FileShare, Int32, FileOptions)

Initialisiert eine neue Instanz der FileStream-Klasse mit den Angaben für den Pfad, den Erstellungsmodus, die Lese-/Schreib- und Freigabeberechtigung, die Zugriffsmöglichkeiten anderer FileStreams auf die gleiche Datei, die Puffergröße und zusätzliche Dateioptionen.

public:
 FileStream(System::String ^ path, System::IO::FileMode mode, System::IO::FileAccess access, System::IO::FileShare share, int bufferSize, System::IO::FileOptions options);

public FileStream (string path, System.IO.FileMode mode, System.IO.FileAccess access, System.IO.FileShare share, int bufferSize, System.IO.FileOptions options);

new System.IO.FileStream : string * System.IO.FileMode * System.IO.FileAccess * System.IO.FileShare * int * System.IO.FileOptions -> System.IO.FileStream

Public Sub New (path As String, mode As FileMode, access As FileAccess, share As FileShare, bufferSize As Integer, options As FileOptions)

Parameter

path: String

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

mode: FileMode

Einer der Enumerationswerte, der bestimmt, wie die Datei geöffnet oder erstellt wird.

access: FileAccess

Eine bitweise Kombination der Enumerationswerte, die bestimmt, wie vom FileStream-Objekt auf die Datei zugegriffen werden kann. Dies bestimmt ebenfalls die von den CanRead- und CanWrite-Eigenschaften des FileStream-Objekts zurückgegebenen Werte. CanSeek ist true, wenn path eine Datei auf einem Datenträger darstellt.

share: FileShare

Eine bitweise Kombination der Enumerationswerte, die bestimmt, wie die Datei von Prozessen gemeinsam verwendet wird.

bufferSize: Int32

Ein positiver Int32-Wert größer als 0 (null), der die Puffergröße angibt. Die Standardpuffergröße ist 4096.

options: FileOptions

Eine bitweise Kombination der Enumerationswerte, die zusätzliche Dateioptionen angibt.

Ausnahmen

ArgumentNullException

path ist null.

ArgumentException

.NET Framework und .NET Core-Versionen vor 2.1: ist eine leere Zeichenfolge (""), enthält nur Leerzeichen oder mindestens ein path 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.

ArgumentOutOfRangeException

bufferSize ist negativ oder 0 (null).

- oder - mode, access oder share enthält einen ungültigen Wert.

FileNotFoundException

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.

SecurityException

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

DirectoryNotFoundException

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

UnauthorizedAccessException

- oder - Encrypted ist für options angegeben, aber Dateiverschlüsselung wird auf der aktuellen Plattform nicht unterstützt.

PathTooLongException

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.

Beispiele

Im folgenden Beispiel werden Daten in eine Datei schreibt und dann mithilfe des -Objekts FileStream gelesen.

#using <System.dll>

using namespace System;
using namespace System::IO;
using namespace System::Text;
using namespace System::Security::AccessControl;

int main()
{
    try
    {
        // Create a file and write data to it.

        // Create an array of bytes.
        array<Byte>^ messageByte =
            Encoding::ASCII->GetBytes("Here is some data.");

        // Create a file using the FileStream class.
        FileStream^ fWrite = gcnew FileStream("test.txt", FileMode::Create,
            FileAccess::ReadWrite, FileShare::None, 8, FileOptions::None);

        // Write the number of bytes to the file.
        fWrite->WriteByte((Byte)messageByte->Length);

        // Write the bytes to the file.
        fWrite->Write(messageByte, 0, messageByte->Length);

        // Close the stream.
        fWrite->Close();


        // Open a file and read the number of bytes.

        FileStream^ fRead = gcnew FileStream("test.txt", 
            FileMode::Open);

        // The first byte is the string length.
        int length = (int)fRead->ReadByte();

        // Create a new byte array for the data.
        array<Byte>^ readBytes = gcnew array<Byte>(length);

        // Read the data from the file.
        fRead->Read(readBytes, 0, readBytes->Length);

        // Close the stream.
        fRead->Close();

        // Display the data.
        Console::WriteLine(Encoding::ASCII->GetString(readBytes));

        Console::WriteLine("Done writing and reading data.");
    }
    catch (IOException^ ex)
    {
        Console::WriteLine(ex->Message);
    }
}

using System;
using System.IO;
using System.Text;
using System.Security.AccessControl;

namespace FileSystemExample
{
    class FileStreamExample
    {
        public static void Main()
        {
            try
            {
                // Create a file and write data to it.

                // Create an array of bytes.
                byte[] messageByte = Encoding.ASCII.GetBytes("Here is some data.");

                // Create a file using the FileStream class.
                FileStream fWrite = new FileStream("test.txt", FileMode.Create, FileAccess.ReadWrite, FileShare.None, 8, FileOptions.None);

                // Write the number of bytes to the file.
                fWrite.WriteByte((byte)messageByte.Length);

                // Write the bytes to the file.
                fWrite.Write(messageByte, 0, messageByte.Length);

                // Close the stream.
                fWrite.Close();

                // Open a file and read the number of bytes.

                FileStream fRead = new FileStream("test.txt", FileMode.Open);

                // The first byte is the string length.
                int length = (int)fRead.ReadByte();

                // Create a new byte array for the data.
                byte[] readBytes = new byte[length];

                // Read the data from the file.
                fRead.Read(readBytes, 0, readBytes.Length);

                // Close the stream.
                fRead.Close();

                // Display the data.
                Console.WriteLine(Encoding.ASCII.GetString(readBytes));

                Console.WriteLine("Done writing and reading data.");
            }
            catch (Exception e)
            {
                Console.WriteLine(e);
            }

            Console.ReadLine();
        }
    }
}

Imports System.IO
Imports System.Text
Imports System.Security.AccessControl



Module FileStreamExample

    Sub Main()
        Try
            ' Create a file and write data to it.
            ' Create an array of bytes.
            Dim messageByte As Byte() = Encoding.ASCII.GetBytes("Here is some data.")

            ' Create a file using the FileStream class.
            Dim fWrite As New FileStream("test.txt", FileMode.Create, FileAccess.ReadWrite, FileShare.None, 8, FileOptions.None)

            ' Write the number of bytes to the file.
            fWrite.WriteByte(System.Convert.ToByte(messageByte.Length))

            ' Write the bytes to the file.
            fWrite.Write(messageByte, 0, messageByte.Length)

            ' Close the stream.
            fWrite.Close()


            ' Open a file and read the number of bytes.
            Dim fRead As New FileStream("test.txt", FileMode.Open)

            ' The first byte is the string length.
            Dim length As Integer = Fix(fRead.ReadByte())

            ' Create a new byte array for the data.
            Dim readBytes(length) As Byte

            ' Read the data from the file.
            fRead.Read(readBytes, 0, readBytes.Length)

            ' Close the stream.
            fRead.Close()

            ' Display the data.
            Console.WriteLine(Encoding.ASCII.GetString(readBytes))

            Console.WriteLine("Done writing and reading data.")
        Catch e As Exception
            Console.WriteLine(e)
        End Try

        Console.ReadLine()

    End Sub
End Module

Hinweise

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

Der fileOptions -Parameter wird verwendet, um Zugriff auf erweiterte Vorgänge zu ermöglichen, die beim Erstellen eines -Objekts genutzt werden FileStream können.

Der path -Parameter kann ein Dateiname sein, einschließlich einer Datei auf einer Universal Naming Convention(UNC)-Freigabe.

Hinweis

Achtung

Eine Liste der allgemeinen Datei- und Verzeichnisvorgänge finden Sie unter Allgemeine E/A-Aufgaben.

Siehe auch

Gilt für:

FileStream(String, FileMode, FileAccess, FileShare, Int32)

Initialisiert eine neue Instanz der FileStream-Klasse mit den Angaben für den Pfad, den Erstellungsmodus, die Lese-/Schreib- und Freigabeberechtigung sowie die Puffergröße.

public:
 FileStream(System::String ^ path, System::IO::FileMode mode, System::IO::FileAccess access, System::IO::FileShare share, int bufferSize);

public FileStream (string path, System.IO.FileMode mode, System.IO.FileAccess access, System.IO.FileShare share, int bufferSize);

new System.IO.FileStream : string * System.IO.FileMode * System.IO.FileAccess * System.IO.FileShare * int -> System.IO.FileStream

Public Sub New (path As String, mode As FileMode, access As FileAccess, share As FileShare, bufferSize As Integer)

Parameter

path: String

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

mode: FileMode

Einer der Enumerationswerte, der bestimmt, wie die Datei geöffnet oder erstellt wird.

access: FileAccess

share: FileShare

Eine bitweise Kombination der Enumerationswerte, die bestimmt, wie die Datei von Prozessen gemeinsam verwendet wird.

bufferSize: Int32

Ein positiver Int32-Wert größer als 0 (null), der die Puffergröße angibt. Die Standardpuffergröße ist 4096.

Ausnahmen

ArgumentNullException

path ist null.

ArgumentException

.NET Framework und .NET Core-Versionen vor 2.1: ist eine leere Zeichenfolge (""), enthält nur Leerzeichen oder mindestens ein path 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.

ArgumentOutOfRangeException

bufferSize ist negativ oder 0 (null).

- oder - mode, access oder share enthält einen ungültigen Wert.

FileNotFoundException

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.

SecurityException

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

DirectoryNotFoundException

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

UnauthorizedAccessException

PathTooLongException

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.

Hinweise

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

Der path Parameter kann ein Dateiname sein, einschließlich einer Datei auf einer Universal Naming Convention(UNC)-Freigabe.

Hinweis

Achtung

Eine Liste der allgemeinen Datei- und Verzeichnisvorgänge finden Sie unter Allgemeine E/A-Aufgaben.

Siehe auch

Gilt für:

FileStream(IntPtr, FileAccess, Boolean, Int32, Boolean)

Achtung

This constructor has been deprecated. Please use new FileStream(SafeFileHandle handle, FileAccess access, int bufferSize, bool isAsync) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed. https://go.microsoft.com/fwlink/?linkid=14202

Achtung

This constructor has been deprecated. Use FileStream(SafeFileHandle handle, FileAccess access, int bufferSize, bool isAsync) and optionally make a new SafeFileHandle with ownsHandle=false if needed instead.

Achtung

Use FileStream(SafeFileHandle handle, FileAccess access, int bufferSize, bool isAsync) instead

Initialisiert eine neue Instanz der FileStream-Klasse für das angegebene Dateihandle mit den Angaben für die Lese-/Schreibberechtigung, den Besitz der FileStream-Instanz, die Puffergröße und den synchronen bzw. asynchronen Zustand.

public:
 FileStream(IntPtr handle, System::IO::FileAccess access, bool ownsHandle, int bufferSize, bool isAsync);

[System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access, int bufferSize, bool isAsync) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  https://go.microsoft.com/fwlink/?linkid=14202")]
public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle, int bufferSize, bool isAsync);

[System.Obsolete("This constructor has been deprecated. Use FileStream(SafeFileHandle handle, FileAccess access, int bufferSize, bool isAsync) and optionally make a new SafeFileHandle with ownsHandle=false if needed instead.")]
public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle, int bufferSize, bool isAsync);

public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle, int bufferSize, bool isAsync);

[System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access, int bufferSize, bool isAsync) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  http://go.microsoft.com/fwlink/?linkid=14202")]
public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle, int bufferSize, bool isAsync);

[System.Obsolete("Use FileStream(SafeFileHandle handle, FileAccess access, int bufferSize, bool isAsync) instead")]
public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle, int bufferSize, bool isAsync);

[<System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access, int bufferSize, bool isAsync) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  https://go.microsoft.com/fwlink/?linkid=14202")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess * bool * int * bool -> System.IO.FileStream

[<System.Obsolete("This constructor has been deprecated. Use FileStream(SafeFileHandle handle, FileAccess access, int bufferSize, bool isAsync) and optionally make a new SafeFileHandle with ownsHandle=false if needed instead.")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess * bool * int * bool -> System.IO.FileStream

new System.IO.FileStream : nativeint * System.IO.FileAccess * bool * int * bool -> System.IO.FileStream

[<System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access, int bufferSize, bool isAsync) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  http://go.microsoft.com/fwlink/?linkid=14202")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess * bool * int * bool -> System.IO.FileStream

[<System.Obsolete("Use FileStream(SafeFileHandle handle, FileAccess access, int bufferSize, bool isAsync) instead")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess * bool * int * bool -> System.IO.FileStream

Public Sub New (handle As IntPtr, access As FileAccess, ownsHandle As Boolean, bufferSize As Integer, isAsync As Boolean)

Parameter

handle: IntPtr
nativeint

Ein Dateihandle für die Datei, die von diesem FileStream-Objekt gekapselt wird.

access: FileAccess

Eine bitweise Kombination der Enumerationswerte, die die Eigenschaften CanRead und CanWrite des FileStream-Objekts festlegen.

ownsHandle: Boolean

true, wenn das Dateihandle im Besitz dieser FileStream-Instanz sein wird, andernfalls false.

bufferSize: Int32

Ein positiver Int32-Wert größer als 0 (null), der die Puffergröße angibt. Die Standardpuffergröße ist 4096.

isAsync: Boolean

true, wenn das Handle asynchron geöffnet wurde (im überlappenden E/A-Modus), andernfalls false.

Attribute: ObsoleteAttribute

Ausnahmen

ArgumentOutOfRangeException

access ist kleiner als FileAccess.Read oder größer als FileAccess.ReadWrite oder bufferSize ist kleiner als oder gleich 0.

ArgumentException

Das Handle ist ungültig.

IOException

Ein E/A-Fehler, z. B. ein Datenträgerfehler, ist aufgetreten.

- oder -

Der Stream wurde geschlossen.

SecurityException

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

UnauthorizedAccessException

Hinweise

Das FileStream -Objekt erhält den angegebenen Zugriff auf die Datei. Der Besitz des Handles ist wie angegeben. Wenn dieser FileStream das Handle besitzt, schließt ein Aufruf der Close -Methode auch das Handle. Insbesondere wird die Handleanzahl der Datei dekrementiert. Das FileStream -Objekt erhält die angegebene Puffergröße.

FileStream geht davon aus, dass es die exklusive Kontrolle über das Handle hat. Lesen, Schreiben oder Suchen, während ein auch ein Handle FileStream enthält, kann zu Datenbeschädigung führen. Rufen Sie aus Datenschutzgründen auf, bevor Sie das Handle verwenden, und vermeiden Sie das Aufrufen anderer Methoden als nach der Verwendung Flush Close des Handles. Alternativ können Sie lesen und in das Handle schreiben, bevor Sie diesen Konstruktor FileStream aufrufen.

FileShare.Read ist die Standardeinstellung für FileStream diese Konstruktoren ohne FileShare Parameter.

Achtung

Eine Liste der allgemeinen Datei- und Verzeichnisvorgänge finden Sie unter Allgemeine E/A-Aufgaben.

Siehe auch

Gilt für:

FileStream(String, FileMode, FileAccess, FileShare)

Initialisiert eine neue Instanz der FileStream-Klasse mit den Angaben für den Pfad, den Erstellungsmodus, die Lese-/Schreib- und Freigabeberechtigung.

public:
 FileStream(System::String ^ path, System::IO::FileMode mode, System::IO::FileAccess access, System::IO::FileShare share);

public FileStream (string path, System.IO.FileMode mode, System.IO.FileAccess access, System.IO.FileShare share);

new System.IO.FileStream : string * System.IO.FileMode * System.IO.FileAccess * System.IO.FileShare -> System.IO.FileStream

Public Sub New (path As String, mode As FileMode, access As FileAccess, share As FileShare)

Parameter

path: String

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

mode: FileMode

Einer der Enumerationswerte, der bestimmt, wie die Datei geöffnet oder erstellt wird.

access: FileAccess

share: FileShare

Eine bitweise Kombination der Enumerationswerte, die bestimmt, wie die Datei von Prozessen gemeinsam verwendet wird.

Ausnahmen

ArgumentNullException

path ist null.

ArgumentException

.NET Framework und .NET Core-Versionen vor 2.1: ist eine leere Zeichenfolge (""), enthält nur Leerzeichen oder mindestens ein path 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.

FileNotFoundException

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.

SecurityException

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

DirectoryNotFoundException

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

UnauthorizedAccessException

PathTooLongException

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.

ArgumentOutOfRangeException

mode enthält einen ungültigen Wert.

Beispiele

Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die -Methode bereitgestellt Lock wird.

FileStream^ fileStream = gcnew FileStream( "Test#@@#.dat",FileMode::OpenOrCreate,FileAccess::ReadWrite,FileShare::ReadWrite );

using(FileStream fileStream = new FileStream(
    "Test#@@#.dat", FileMode.OpenOrCreate,
    FileAccess.ReadWrite, FileShare.ReadWrite))

Dim aFileStream As New FileStream( _
    "Test#@@#.dat", FileMode.OpenOrCreate, _
    FileAccess.ReadWrite, FileShare.ReadWrite)

Hinweise

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

Der path Parameter kann ein Dateiname sein, einschließlich einer Datei auf einer Universal Naming Convention(UNC)-Freigabe.

Der Konstruktor erhält Lese-/Schreibzugriff auf die Datei, und er wird geöffnet, und der Lesezugriff wird gemeinsam verwendet (d. h., Anforderungen zum Öffnen der Datei zum Schreiben durch diesen oder einen anderen Prozess fehlschlagen, bis das Objekt geschlossen wurde, aber Leseversuche sind FileStream erfolgreich). Die Puffergröße ist auf die Standardgröße von 4.096 Bytes (4 KB) festgelegt.

Hinweis

Achtung

Eine Liste der allgemeinen Datei- und Verzeichnisvorgänge finden Sie unter Allgemeine E/A-Aufgaben.

Siehe auch

Gilt für:

FileStream(IntPtr, FileAccess, Boolean, Int32)

Achtung

This constructor has been deprecated. Please use new FileStream(SafeFileHandle handle, FileAccess access, int bufferSize) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed. https://go.microsoft.com/fwlink/?linkid=14202

Achtung

This constructor has been deprecated. Use FileStream(SafeFileHandle handle, FileAccess access, int bufferSize) and optionally make a new SafeFileHandle with ownsHandle=false if needed instead.

Achtung

Use FileStream(SafeFileHandle handle, FileAccess access, int bufferSize) instead

Initialisiert eine neue Instanz der FileStream-Klasse für das angegebene Dateihandle mit den Angaben für die Lese-/Schreibberechtigung, den Besitz der FileStream-Instanz und die Puffergröße.

public:
 FileStream(IntPtr handle, System::IO::FileAccess access, bool ownsHandle, int bufferSize);

[System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access, int bufferSize) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  https://go.microsoft.com/fwlink/?linkid=14202")]
public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle, int bufferSize);

[System.Obsolete("This constructor has been deprecated. Use FileStream(SafeFileHandle handle, FileAccess access, int bufferSize) and optionally make a new SafeFileHandle with ownsHandle=false if needed instead.")]
public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle, int bufferSize);

public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle, int bufferSize);

[System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access, int bufferSize) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  http://go.microsoft.com/fwlink/?linkid=14202")]
public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle, int bufferSize);

[System.Obsolete("Use FileStream(SafeFileHandle handle, FileAccess access, int bufferSize) instead")]
public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle, int bufferSize);

[<System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access, int bufferSize) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  https://go.microsoft.com/fwlink/?linkid=14202")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess * bool * int -> System.IO.FileStream

[<System.Obsolete("This constructor has been deprecated. Use FileStream(SafeFileHandle handle, FileAccess access, int bufferSize) and optionally make a new SafeFileHandle with ownsHandle=false if needed instead.")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess * bool * int -> System.IO.FileStream

new System.IO.FileStream : nativeint * System.IO.FileAccess * bool * int -> System.IO.FileStream

[<System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access, int bufferSize) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  http://go.microsoft.com/fwlink/?linkid=14202")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess * bool * int -> System.IO.FileStream

[<System.Obsolete("Use FileStream(SafeFileHandle handle, FileAccess access, int bufferSize) instead")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess * bool * int -> System.IO.FileStream

Public Sub New (handle As IntPtr, access As FileAccess, ownsHandle As Boolean, bufferSize As Integer)

Parameter

handle: IntPtr
nativeint

Ein Dateihandle für die Datei, die von diesem FileStream-Objekt gekapselt wird.

access: FileAccess

Eine bitweise Kombination der Enumerationswerte, die die Eigenschaften CanRead und CanWrite des FileStream-Objekts festlegen.

ownsHandle: Boolean

true, wenn das Dateihandle im Besitz dieser FileStream-Instanz sein wird, andernfalls false.

bufferSize: Int32

Ein positiver Int32-Wert größer als 0 (null), der die Puffergröße angibt. Die Standardpuffergröße ist 4096.

Attribute: ObsoleteAttribute

Ausnahmen

ArgumentOutOfRangeException

bufferSize ist ein negativer Wert.

IOException

Ein E/A-Fehler, z. B. ein Datenträgerfehler, ist aufgetreten.

- oder -

Der Stream wurde geschlossen.

SecurityException

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

UnauthorizedAccessException

Hinweise

FileShare.Read ist die Standardeinstellung für FileStream diese Konstruktoren ohne FileShare Parameter.

Achtung

Eine Liste der allgemeinen Datei- und Verzeichnisvorgänge finden Sie unter Allgemeine E/A-Aufgaben.

Siehe auch

Gilt für:

FileStream(String, FileMode, FileAccess, FileShare, Int32, Boolean)

Initialisiert eine neue Instanz der FileStream-Klasse mit den Angaben für den Pfad, den Erstellungsmodus, die Lese-/Schreib- und Freigabeberechtigung, die Puffergröße und den synchronen bzw. asynchronen Zustand.

public:
 FileStream(System::String ^ path, System::IO::FileMode mode, System::IO::FileAccess access, System::IO::FileShare share, int bufferSize, bool useAsync);

public FileStream (string path, System.IO.FileMode mode, System.IO.FileAccess access, System.IO.FileShare share, int bufferSize, bool useAsync);

new System.IO.FileStream : string * System.IO.FileMode * System.IO.FileAccess * System.IO.FileShare * int * bool -> System.IO.FileStream

Public Sub New (path As String, mode As FileMode, access As FileAccess, share As FileShare, bufferSize As Integer, useAsync As Boolean)

Parameter

path: String

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

mode: FileMode

Einer der Enumerationswerte, der bestimmt, wie die Datei geöffnet oder erstellt wird.

access: FileAccess

share: FileShare

Eine bitweise Kombination der Enumerationswerte, die bestimmt, wie die Datei von Prozessen gemeinsam verwendet wird.

bufferSize: Int32

Ein positiver Int32-Wert größer als 0 (null), der die Puffergröße angibt. Die Standardpuffergröße ist 4096.

useAsync: Boolean

Gibt an, ob eine asynchrone E/A oder eine synchrone E/A verwendet wird. Beachten Sie jedoch, dass das zugrunde liegende Betriebssystem möglicherweise keine asynchrone E/A unterstützt, sodass das Handle je nach Plattform auch bei der Angabe von true möglicherweise synchron geöffnet wird. Bei asynchronem Öffnen liefern die BeginRead(Byte[], Int32, Int32, AsyncCallback, Object)-Methode und die BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object)-Methode bei umfangreichen Lese- oder Schreibvorgängen eine höhere Leistung, sind aber möglicherweise bei kleinen Lese- und Schreibvorgängen wesentlich langsamer. Wenn die Anwendung die Vorteile der asynchronen E/A nutzen kann, legen Sie den useAsync-Parameter auf true fest. Wird die asynchrone E/A richtig eingesetzt, können Anwendungen um ein Zehnfaches beschleunigt werden. Wenn die Anwendung jedoch nicht an eine asynchrone E/A angepasst wurde, kann dies die Leistung auch um das Zehnfache verringern.

Ausnahmen

ArgumentNullException

path ist null.

ArgumentException

.NET Framework und .NET Core-Versionen vor 2.1: ist eine leere Zeichenfolge (""), enthält nur Leerzeichen oder mindestens ein path 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.

ArgumentOutOfRangeException

bufferSize ist negativ oder 0 (null).

- oder - mode, access oder share enthält einen ungültigen Wert.

FileNotFoundException

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.

SecurityException

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

DirectoryNotFoundException

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

UnauthorizedAccessException

PathTooLongException

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.

Beispiele

Das folgende Codebeispiel zeigt, wie Daten asynchron in eine Datei geschrieben und dann überprüft werden, ob die Daten ordnungsgemäß geschrieben wurden. Ein State -Objekt wird erstellt, um Informationen vom Hauptthread an die Methoden und EndReadCallback zu EndWriteCallback übergeben.

using namespace System;
using namespace System::IO;
using namespace System::Threading;

// Maintain state information to be passed to 
// EndWriteCallback and EndReadCallback.
ref class State
{
private:

   // fStream is used to read and write to the file.
   FileStream^ fStream;

   // writeArray stores data that is written to the file.
   array<Byte>^writeArray;

   // readArray stores data that is read from the file.
   array<Byte>^readArray;

   // manualEvent signals the main thread 
   // when verification is complete.
   ManualResetEvent^ manualEvent;

public:
   State( FileStream^ fStream, array<Byte>^writeArray, ManualResetEvent^ manualEvent )
   {
      this->fStream = fStream;
      this->writeArray = writeArray;
      this->manualEvent = manualEvent;
      readArray = gcnew array<Byte>(writeArray->Length);
   }


   property FileStream^ FStream 
   {
      FileStream^ get()
      {
         return fStream;
      }

   }

   property array<Byte>^ WriteArray 
   {
      array<Byte>^ get()
      {
         return writeArray;
      }

   }

   property array<Byte>^ ReadArray 
   {
      array<Byte>^ get()
      {
         return readArray;
      }

   }

   property ManualResetEvent^ ManualEvent 
   {
      ManualResetEvent^ get()
      {
         return manualEvent;
      }

   }

};

ref class FStream
{
private:

   // When BeginRead is finished reading data from the file, the 
   // EndReadCallback method is called to end the asynchronous 
   // read operation and then verify the data.
   static void EndReadCallback( IAsyncResult^ asyncResult )
   {
      State^ tempState = dynamic_cast<State^>(asyncResult->AsyncState);
      int readCount = tempState->FStream->EndRead( asyncResult );
      int i = 0;
      while ( i < readCount )
      {
         if ( tempState->ReadArray[ i ] != tempState->WriteArray[ i++ ] )
         {
            Console::WriteLine( "Error writing data." );
            tempState->FStream->Close();
            return;
         }
      }

      Console::WriteLine( "The data was written to {0} "
      "and verified.", tempState->FStream->Name );
      tempState->FStream->Close();
      
      // Signal the main thread that the verification is finished.
      tempState->ManualEvent->Set();
   }


public:

   // When BeginWrite is finished writing data to the file, the
   // EndWriteCallback method is called to end the asynchronous 
   // write operation and then read back and verify the data.
   static void EndWriteCallback( IAsyncResult^ asyncResult )
   {
      State^ tempState = dynamic_cast<State^>(asyncResult->AsyncState);
      FileStream^ fStream = tempState->FStream;
      fStream->EndWrite( asyncResult );
      
      // Asynchronously read back the written data.
      fStream->Position = 0;
      asyncResult = fStream->BeginRead( tempState->ReadArray, 0, tempState->ReadArray->Length, gcnew AsyncCallback( &FStream::EndReadCallback ), tempState );
      
      // Concurrently do other work, such as 
      // logging the write operation.
   }

};


int main()
{
   
   // Create a synchronization object that gets 
   // signaled when verification is complete.
   ManualResetEvent^ manualEvent = gcnew ManualResetEvent( false );
   
   // Create the data to write to the file.
   array<Byte>^writeArray = gcnew array<Byte>(100000);
   (gcnew Random)->NextBytes( writeArray );
   FileStream^ fStream = gcnew FileStream(  "Test#@@#.dat",FileMode::Create,FileAccess::ReadWrite,FileShare::None,4096,true );
   
   // Check that the FileStream was opened asynchronously.
   Console::WriteLine( "fStream was {0}opened asynchronously.", fStream->IsAsync ? (String^)"" : "not " );
   
   // Asynchronously write to the file.
   IAsyncResult^ asyncResult = fStream->BeginWrite( writeArray, 0, writeArray->Length, gcnew AsyncCallback( &FStream::EndWriteCallback ), gcnew State( fStream,writeArray,manualEvent ) );
   
   // Concurrently do other work and then wait 
   // for the data to be written and verified.
   manualEvent->WaitOne( 5000, false );
}

using System;
using System.IO;
using System.Threading;

class FStream
{
    static void Main()
    {
        // Create a synchronization object that gets
        // signaled when verification is complete.
        ManualResetEvent manualEvent = new ManualResetEvent(false);

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

        FileStream fStream =
            new FileStream("Test#@@#.dat", FileMode.Create,
            FileAccess.ReadWrite, FileShare.None, 4096, true);

        // Check that the FileStream was opened asynchronously.
        Console.WriteLine("fStream was {0}opened asynchronously.",
            fStream.IsAsync ? "" : "not ");

        // Asynchronously write to the file.
        IAsyncResult asyncResult = fStream.BeginWrite(
            writeArray, 0, writeArray.Length,
            new AsyncCallback(EndWriteCallback),
            new State(fStream, writeArray, manualEvent));

        // Concurrently do other work and then wait
        // for the data to be written and verified.
        manualEvent.WaitOne(5000, false);
    }

    // When BeginWrite is finished writing data to the file, the
    // EndWriteCallback method is called to end the asynchronous
    // write operation and then read back and verify the data.
    static void EndWriteCallback(IAsyncResult asyncResult)
    {
        State tempState = (State)asyncResult.AsyncState;
        FileStream fStream = tempState.FStream;
        fStream.EndWrite(asyncResult);

        // Asynchronously read back the written data.
        fStream.Position = 0;
        asyncResult = fStream.BeginRead(
            tempState.ReadArray, 0 , tempState.ReadArray.Length,
            new AsyncCallback(EndReadCallback), tempState);

        // Concurrently do other work, such as
        // logging the write operation.
    }

    // When BeginRead is finished reading data from the file, the
    // EndReadCallback method is called to end the asynchronous
    // read operation and then verify the data.
    static void EndReadCallback(IAsyncResult asyncResult)
    {
        State tempState = (State)asyncResult.AsyncState;
        int readCount = tempState.FStream.EndRead(asyncResult);

        int i = 0;
        while(i < readCount)
        {
            if(tempState.ReadArray[i] != tempState.WriteArray[i++])
            {
                Console.WriteLine("Error writing data.");
                tempState.FStream.Close();
                return;
            }
        }
        Console.WriteLine("The data was written to {0} and verified.",
            tempState.FStream.Name);
        tempState.FStream.Close();

        // Signal the main thread that the verification is finished.
        tempState.ManualEvent.Set();
    }

    // Maintain state information to be passed to
    // EndWriteCallback and EndReadCallback.
    class State
    {
        // fStream is used to read and write to the file.
        FileStream fStream;

        // writeArray stores data that is written to the file.
        byte[] writeArray;

        // readArray stores data that is read from the file.
        byte[] readArray;

        // manualEvent signals the main thread
        // when verification is complete.
        ManualResetEvent manualEvent;

        public State(FileStream fStream, byte[] writeArray,
            ManualResetEvent manualEvent)
        {
            this.fStream   = fStream;
            this.writeArray = writeArray;
            this.manualEvent = manualEvent;
            readArray = new byte[writeArray.Length];
        }

        public FileStream FStream
        { get{ return fStream; } }

        public byte[] WriteArray
        { get{ return writeArray; } }

        public byte[] ReadArray
        { get{ return readArray; } }

        public ManualResetEvent ManualEvent
        { get{ return manualEvent; } }
    }
}

Imports System.IO
Imports System.Threading

Class FStream

    Shared Sub Main()

        ' Create a synchronization object that gets 
        ' signaled when verification is complete.
        Dim manualEvent As New ManualResetEvent(False)

        ' Create random data to write to the file.
        Dim writeArray(100000) As Byte
        Dim randomGenerator As New Random()
        randomGenerator.NextBytes(writeArray)

        Dim fStream As New FileStream("Test#@@#.dat", _
            FileMode.Create, FileAccess.ReadWrite, _
            FileShare.None, 4096, True)

        ' Check that the FileStream was opened asynchronously.
        If fStream.IsAsync = True
            Console.WriteLine("fStream was opened asynchronously.")
        Else
            Console.WriteLine("fStream was not opened asynchronously.")
        End If

        ' Asynchronously write to the file.
        Dim asyncResult As IAsyncResult = fStream.BeginWrite( _
            writeArray, 0, writeArray.Length, _
            AddressOf EndWriteCallback , _
            New State(fStream, writeArray, manualEvent))

        ' Concurrently do other work and then wait
        ' for the data to be written and verified.
        manualEvent.WaitOne(5000, False)
    End Sub

    ' When BeginWrite is finished writing data to the file, the
    ' EndWriteCallback method is called to end the asynchronous 
    ' write operation and then read back and verify the data.
    Private Shared Sub EndWriteCallback(asyncResult As IAsyncResult)
        Dim tempState As State = _
            DirectCast(asyncResult.AsyncState, State)
        Dim fStream As FileStream = tempState.FStream
        fStream.EndWrite(asyncResult)

        ' Asynchronously read back the written data.
        fStream.Position = 0
        asyncResult = fStream.BeginRead( _ 
            tempState.ReadArray, 0 , tempState.ReadArray.Length, _
            AddressOf EndReadCallback, tempState)

        ' Concurrently do other work, such as 
        ' logging the write operation.
    End Sub

    ' When BeginRead is finished reading data from the file, the 
    ' EndReadCallback method is called to end the asynchronous 
    ' read operation and then verify the data.
   Private Shared Sub EndReadCallback(asyncResult As IAsyncResult)
        Dim tempState As State = _
            DirectCast(asyncResult.AsyncState, State)
        Dim readCount As Integer = _
            tempState.FStream.EndRead(asyncResult)

        Dim i As Integer = 0
        While(i < readCount)
            If(tempState.ReadArray(i) <> tempState.WriteArray(i))
                Console.WriteLine("Error writing data.")
                tempState.FStream.Close()
                Return
            End If
            i += 1
        End While

        Console.WriteLine("The data was written to {0} and " & _
            "verified.", tempState.FStream.Name)
        tempState.FStream.Close()

        ' Signal the main thread that the verification is finished.
        tempState.ManualEvent.Set()
    End Sub

    ' Maintain state information to be passed to 
    ' EndWriteCallback and EndReadCallback.
    Private Class State

        ' fStreamValue is used to read and write to the file.
        Dim fStreamValue As FileStream

        ' writeArrayValue stores data that is written to the file.
        Dim writeArrayValue As Byte()

        ' readArrayValue stores data that is read from the file.
        Dim readArrayValue As Byte()

        ' manualEvent signals the main thread 
        ' when verification is complete.
        Dim manualEventValue As ManualResetEvent 

        Sub New(aStream As FileStream, anArray As Byte(), _
            manualEvent As ManualResetEvent)

            fStreamValue     = aStream
            writeArrayValue  = anArray
            manualEventValue = manualEvent
            readArrayValue   = New Byte(anArray.Length - 1){}
        End Sub    

            Public ReadOnly Property FStream() As FileStream
                Get
                    Return fStreamValue
                End Get
            End Property

            Public ReadOnly Property WriteArray() As Byte()
                Get
                    Return writeArrayValue
                End Get
            End Property

            Public ReadOnly Property ReadArray() As Byte()
                Get
                    Return readArrayValue
                End Get
            End Property

            Public ReadOnly Property ManualEvent() As ManualResetEvent
                Get
                    Return manualEventValue
                End Get
            End Property
    End Class 
   
End Class

Hinweise

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

Der path -Parameter kann ein Dateiname sein, einschließlich einer Datei auf einer Universal Naming Convention(UNC)-Freigabe.

Hinweis

Achtung

Eine Liste der allgemeinen Datei- und Verzeichnisvorgänge finden Sie unter Allgemeine E/A-Aufgaben.

Siehe auch

Gilt für:

FileStream(String, FileMode, FileAccess)

Initialisiert eine neue Instanz der FileStream-Klasse mit den Angaben für den Pfad, den Erstellungsmodus und die Lese-/Schreibberechtigung.

public:
 FileStream(System::String ^ path, System::IO::FileMode mode, System::IO::FileAccess access);

public FileStream (string path, System.IO.FileMode mode, System.IO.FileAccess access);

new System.IO.FileStream : string * System.IO.FileMode * System.IO.FileAccess -> System.IO.FileStream

Public Sub New (path As String, mode As FileMode, access As FileAccess)

Parameter

path: String

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

mode: FileMode

Einer der Enumerationswerte, der bestimmt, wie die Datei geöffnet oder erstellt wird.

access: FileAccess

Ausnahmen

ArgumentNullException

path ist null.

ArgumentException

.NET Framework und .NET Core-Versionen vor 2.1: ist eine leere Zeichenfolge (""), enthält nur Leerzeichen oder mindestens ein path 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.

FileNotFoundException

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.

SecurityException

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

DirectoryNotFoundException

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

UnauthorizedAccessException

PathTooLongException

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.

ArgumentOutOfRangeException

mode enthält einen ungültigen Wert.

Hinweise

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

Der path Parameter kann ein Dateiname sein, einschließlich einer Datei auf einer Universal Naming Convention(UNC)-Freigabe.

Hinweis

FileShare.Read ist die Standardeinstellung für FileStream diese Konstruktoren ohne FileShare Parameter.

Achtung

Eine Liste der allgemeinen Datei- und Verzeichnisvorgänge finden Sie unter Allgemeine E/A-Aufgaben.

Siehe auch

Gilt für:

FileStream(IntPtr, FileAccess, Boolean)

Achtung

This constructor has been deprecated. Please use new FileStream(SafeFileHandle handle, FileAccess access) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed. https://go.microsoft.com/fwlink/?linkid=14202

Achtung

This constructor has been deprecated. Use FileStream(SafeFileHandle handle, FileAccess access) and optionally make a new SafeFileHandle with ownsHandle=false if needed instead.

Achtung

Use FileStream(SafeFileHandle handle, FileAccess access) instead

Initialisiert eine neue Instanz der FileStream-Klasse für das angegebene Dateihandle mit den Angaben für die Lese-/Schreibberechtigung und für den Besitz der FileStream-Instanz.

public:
 FileStream(IntPtr handle, System::IO::FileAccess access, bool ownsHandle);

[System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  https://go.microsoft.com/fwlink/?linkid=14202")]
public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle);

[System.Obsolete("This constructor has been deprecated. Use FileStream(SafeFileHandle handle, FileAccess access) and optionally make a new SafeFileHandle with ownsHandle=false if needed instead.")]
public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle);

public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle);

[System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  http://go.microsoft.com/fwlink/?linkid=14202")]
public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle);

[System.Obsolete("Use FileStream(SafeFileHandle handle, FileAccess access) instead")]
public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle);

[<System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  https://go.microsoft.com/fwlink/?linkid=14202")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess * bool -> System.IO.FileStream

[<System.Obsolete("This constructor has been deprecated. Use FileStream(SafeFileHandle handle, FileAccess access) and optionally make a new SafeFileHandle with ownsHandle=false if needed instead.")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess * bool -> System.IO.FileStream

new System.IO.FileStream : nativeint * System.IO.FileAccess * bool -> System.IO.FileStream

[<System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  http://go.microsoft.com/fwlink/?linkid=14202")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess * bool -> System.IO.FileStream

[<System.Obsolete("Use FileStream(SafeFileHandle handle, FileAccess access) instead")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess * bool -> System.IO.FileStream

Public Sub New (handle As IntPtr, access As FileAccess, ownsHandle As Boolean)

Parameter

handle: IntPtr
nativeint

Ein Dateihandle für die Datei, die vom aktuellen FileStream-Objekt gekapselt wird.

access: FileAccess

Eine bitweise Kombination der Enumerationswerte, die die Eigenschaften CanRead und CanWrite des FileStream-Objekts festlegen.

ownsHandle: Boolean

true, wenn das Dateihandle im Besitz dieser FileStream-Instanz sein wird, andernfalls false.

Attribute: ObsoleteAttribute

Ausnahmen

ArgumentException

access ist kein Feld von FileAccess.

SecurityException

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

IOException

Ein E/A-Fehler, z. B. ein Datenträgerfehler, ist aufgetreten.

- oder -

Der Stream wurde geschlossen.

UnauthorizedAccessException

Hinweise

Dem FileStream -Objekt wird der angegebene Zugriff auf die Datei gewährt. Der Besitz des Handles ist wie angegeben. Wenn dieser Prozess das Handle besitzt, schließt ein Aufruf der Close -Methode auch das Handle, und die Handleanzahl der Datei wird dekrementiert. Dem FileStream -Objekt wird die Standardpuffergröße von 4.096 Bytes gewährt.

FileShare.Read ist die Standardeinstellung für diese FileStream Konstruktoren ohne FileShare Parameter.

Achtung

Eine Liste der allgemeinen Datei- und Verzeichnisvorgänge finden Sie unter Allgemeine E/A-Aufgaben.

Siehe auch

Gilt für:

FileStream(SafeFileHandle, FileAccess, Int32)

Initialisiert eine neue Instanz der FileStream-Klasse für das angegebene Dateihandle mit den Angaben für die Lese-/Schreibberechtigung und die Puffergröße.

public:
 FileStream(Microsoft::Win32::SafeHandles::SafeFileHandle ^ handle, System::IO::FileAccess access, int bufferSize);

public FileStream (Microsoft.Win32.SafeHandles.SafeFileHandle handle, System.IO.FileAccess access, int bufferSize);

new System.IO.FileStream : Microsoft.Win32.SafeHandles.SafeFileHandle * System.IO.FileAccess * int -> System.IO.FileStream

Public Sub New (handle As SafeFileHandle, access As FileAccess, bufferSize As Integer)

Parameter

handle: SafeFileHandle

Ein Dateihandle für die Datei, die vom aktuellen FileStream-Objekt gekapselt wird.

access: FileAccess

Eine FileAccess-Konstante, die die CanRead- und CanWrite-Eigenschaften des FileStream-Objekts festlegt.

bufferSize: Int32

Ein positiver Int32-Wert größer als 0 (null), der die Puffergröße angibt. Die Standardpuffergröße ist 4096.

Ausnahmen

ArgumentException

Der handle-Parameter ist ein ungültiges Handle.

- oder - Der handle-Parameter ist ein synchrones Handle und wurde asynchron verwendet.

ArgumentOutOfRangeException

Der bufferSize-Parameter ist negativ.

IOException

Ein E/A-Fehler, z. B. ein Datenträgerfehler, ist aufgetreten.

- oder -

Der Stream wurde geschlossen.

SecurityException

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

UnauthorizedAccessException

Hinweise

FileShare.Read ist die Standardeinstellung für diese FileStream Konstruktoren ohne FileShare Parameter.

Achtung

Eine Liste der allgemeinen Datei- und Verzeichnisvorgänge finden Sie unter Allgemeine E/A-Aufgaben.

Siehe auch

Gilt für:

FileStream(SafeFileHandle, FileAccess, Int32, Boolean)

Initialisiert eine neue Instanz der FileStream-Klasse für das angegebene Dateihandle mit den Angaben für die Lese-/Schreibberechtigung, die Puffergröße und den synchronen bzw. asynchronen Zustand.

public:
 FileStream(Microsoft::Win32::SafeHandles::SafeFileHandle ^ handle, System::IO::FileAccess access, int bufferSize, bool isAsync);

public FileStream (Microsoft.Win32.SafeHandles.SafeFileHandle handle, System.IO.FileAccess access, int bufferSize, bool isAsync);

new System.IO.FileStream : Microsoft.Win32.SafeHandles.SafeFileHandle * System.IO.FileAccess * int * bool -> System.IO.FileStream

Public Sub New (handle As SafeFileHandle, access As FileAccess, bufferSize As Integer, isAsync As Boolean)

Parameter

handle: SafeFileHandle

Ein Dateihandle für die Datei, die von diesem FileStream-Objekt gekapselt wird.

access: FileAccess

Eine bitweise Kombination der Enumerationswerte, die die Eigenschaften CanRead und CanWrite des FileStream-Objekts festlegen.

bufferSize: Int32

Ein positiver Int32-Wert größer als 0 (null), der die Puffergröße angibt. Die Standardpuffergröße ist 4096.

isAsync: Boolean

true, wenn das Handle asynchron geöffnet wurde (im überlappenden E/A-Modus), andernfalls false.

Ausnahmen

ArgumentException

Der handle-Parameter ist ein ungültiges Handle.

- oder - Der handle-Parameter ist ein synchrones Handle und wurde asynchron verwendet.

ArgumentOutOfRangeException

Der bufferSize-Parameter ist negativ.

IOException

Ein E/A-Fehler, z. B. ein Datenträgerfehler, ist aufgetreten.

- oder -

Der Stream wurde geschlossen.

SecurityException

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

UnauthorizedAccessException

Hinweise

Sie legen den isAsync Parameter auf true fest, um das Dateihand handle asynchron zu öffnen. Wenn der -Parameter ist, verwendet der Stream überlappende true E/A-Vorgänge, um Dateivorgänge asynchron durchzuführen. Der -Parameter muss jedoch nicht sein, um true die ReadAsync -, WriteAsync - oder -Methode auf CopyToAsync aufruft. Wenn der -Parameter ist und Sie die asynchronen Lese- und Schreibvorgänge aufrufen, wird der UI-Thread immer noch nicht blockiert, aber der tatsächliche isAsync false E/A-Vorgang wird synchron ausgeführt.

FileShare.Read ist die Standardeinstellung für FileStream diese Konstruktoren ohne FileShare Parameter.

Achtung

Eine Liste der allgemeinen Datei- und Verzeichnisvorgänge finden Sie unter Allgemeine E/A-Aufgaben.

Siehe auch

Gilt für:

FileStream(String, FileStreamOptions)

Initialisiert eine neue Instanz der FileStream -Klasse mit dem angegebenen Pfad, dem angegebenen Erstellungsmodus, der Lese-/Schreib- und Freigabeberechtigung, der Puffergröße, zusätzlichen Dateioptionen, der Vorabzuordnungsgröße und dem Zugriff, den andere FileStreams auf dieselbe Datei haben können.

public:
 FileStream(System::String ^ path, System::IO::FileStreamOptions ^ options);

public FileStream (string path, System.IO.FileStreamOptions options);

new System.IO.FileStream : string * System.IO.FileStreamOptions -> System.IO.FileStream

Public Sub New (path As String, options As FileStreamOptions)

Parameter

path: String

Ein relativer oder absoluter Pfad für die Datei, die die aktuelle FileStream Instanz kapselt.

options: FileStreamOptions

Ein Objekt, das optionale FileStream zu verwendende Parameter beschreibt.

Ausnahmen

ArgumentNullException

path oder options ist null.

ArgumentException

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

Oder

path bezieht sich auf ein Nichtdateigerät, z. B. CON:, COM1:oder LPT1:in einer NTFS-Umgebung.

NotSupportedException

path bezieht sich auf ein Nicht-Dateigerät, z. B. CON:, COM1:, LPT1:usw. in einer Nicht-NTFS-Umgebung.

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.

Oder

Der Datenträger war voll (als PreallocationSize bereitgestellt wurde und auf eine reguläre Datei path verweist).

Oder

Die Datei war zu groß (als PreallocationSize bereitgestellt wurde und auf eine reguläre Datei path verweist).

SecurityException

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

DirectoryNotFoundException

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

UnauthorizedAccessException

Der Access angeforderte ist vom Betriebssystem für den angegebenen nicht path zulässig, z. B. wenn Access oder ist und die Datei oder das Verzeichnis für den Write ReadWrite schreibgeschützten Zugriff festgelegt ist.

Oder

Encrypted wird für Options angegeben, aber die Dateiverschlüsselung wird auf der aktuellen Plattform nicht unterstützt.

PathTooLongException

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.

Hinweise

Das Angeben eines Werts für PreallocationSize stellt einen Hinweis auf die Größe der Vorabzuordnung bereit, aber keine starke Garantie. Ausführliche Informationen zur Verwendung finden Sie in der Dokumentation zu PreallocationSize .

Gilt für:

FileStream(String, FileMode)

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

public:
 FileStream(System::String ^ path, System::IO::FileMode mode);

public FileStream (string path, System.IO.FileMode mode);

new System.IO.FileStream : string * System.IO.FileMode -> System.IO.FileStream

Public Sub New (path As String, mode As FileMode)

Parameter

path: String

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

mode: FileMode

Einer der Enumerationswerte, der bestimmt, wie die Datei geöffnet oder erstellt wird.

Ausnahmen

ArgumentException

.NET Framework und .NET Core-Versionen älter als 2.1: 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

UnauthorizedAccessException

path gibt eine schreibgeschützte Datei an.

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.

ArgumentOutOfRangeException

mode enthält einen ungültigen Wert.

Beispiele

Das folgende Codebeispiel zeigt, wie Sie Daten in eine Datei schreiben, byte byte, und dann überprüfen, ob die Daten ordnungsgemäß geschrieben wurden.

using namespace System;
using namespace System::IO;
int main()
{
   String^ fileName =  "Test@##@.dat";
   
   // Create random data to write to the file.
   array<Byte>^dataArray = gcnew array<Byte>(100000);
   (gcnew Random)->NextBytes( dataArray );
   FileStream^ fileStream = gcnew FileStream( fileName,FileMode::Create );
   try
   {
      
      // 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  -1;
         }

      }
      Console::WriteLine( "The data was written to {0} "
      "and verified.", fileStream->Name );
   }
   finally
   {
      fileStream->Close();
   }

}

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);
        }
    }
}

Imports System.IO
Imports System.Text

Class FStream

    Shared Sub Main()

        Const fileName As String = "Test#@@#.dat"

        ' Create random data to write to the file.
        Dim dataArray(100000) As Byte
        Dim randomGenerator As New Random()
        randomGenerator.NextBytes(dataArray)

        Dim fileStream As FileStream = _
            new FileStream(fileName, FileMode.Create)
        Try

            ' Write the data to the file, byte by byte.
            For i As Integer = 0 To dataArray.Length - 1
                fileStream.WriteByte(dataArray(i))
            Next i

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

            ' Read and verify the data.
            For i As Integer = 0 To _
                CType(fileStream.Length, Integer) - 1

                If dataArray(i) <> fileStream.ReadByte() Then
                    Console.WriteLine("Error writing data.")
                    Return
                End If
            Next i
            Console.WriteLine("The data was written to {0} " & _
                "and verified.", fileStream.Name)
        Finally
            fileStream.Close()
        End Try
    
    End Sub
End Class

Hinweise

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

Der path Parameter kann ein Dateiname sein, einschließlich einer Datei auf einer Universal Naming Convention -Freigabe (UNC).

Dem Konstruktor wird Lese-/Schreibzugriff auf die Datei gewährt, und er wird geöffnet, indem der Lesezugriff freigegeben wird (d. h. Anforderungen zum Öffnen der Datei zum Schreiben durch diesen oder einen anderen Prozess schlagen fehl, bis das FileStream Objekt geschlossen wurde, aber Leseversuche erfolgreich sind).

Sie können diesen Konstruktor nicht verwenden, um schreibgeschützte Dateien zu öffnen. Stattdessen müssen Sie einen Konstruktor verwenden, der einen FileAccess Parameter akzeptiert, für den der Wert auf festgelegt FileAccess.Read ist.

Die Puffergröße ist auf die Standardgröße von 4.096 Bytes (4 KB) festgelegt.

Hinweis

path muss keine Datei sein, die auf dem Datenträger gespeichert ist. es kann ein beliebiger Teil eines Systems sein, das den Zugriff über Streams unterstützt. Abhängig vom System kann diese Klasse beispielsweise auf ein physisches Gerät zugreifen.

CanSeek ist true für alle FileStream Objekte, die Dateien kapseln. Wenn path ein Gerät angibt, das sucht nicht unterstützt, ist die CanSeek -Eigenschaft auf dem resultierenden FileStream false . Weitere Informationen finden Sie unter CanSeek.

FileShare.Read ist die Standardeinstellung für diese FileStream Konstruktoren ohne FileShare Parameter.

Wenn der Parameter für Konstruktoren ohne FileAccess Parameter mode auf festgelegt Append ist, ist Write dies der Standardzugriff. Andernfalls wird der Zugriff auf ReadWrite festgelegt.

Achtung

Eine Liste der allgemeinen Datei- und Verzeichnisvorgänge finden Sie unter Allgemeine E/A-Aufgaben.

Siehe auch

Gilt für:

FileStream(IntPtr, FileAccess)

Achtung

This constructor has been deprecated. Please use new FileStream(SafeFileHandle handle, FileAccess access) instead. https://go.microsoft.com/fwlink/?linkid=14202

Achtung

This constructor has been deprecated. Use FileStream(SafeFileHandle handle, FileAccess access) instead.

Achtung

This constructor has been deprecated. Please use new FileStream(SafeFileHandle handle, FileAccess access) instead. http://go.microsoft.com/fwlink/?linkid=14202

Achtung

Use FileStream(SafeFileHandle handle, FileAccess access) instead

Initialisiert eine neue Instanz der FileStream-Klasse für das angegebene Dateihandle und mit der angegebenen Lese- und Schreibberechtigung.

public:
 FileStream(IntPtr handle, System::IO::FileAccess access);

[System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access) instead.  https://go.microsoft.com/fwlink/?linkid=14202")]
public FileStream (IntPtr handle, System.IO.FileAccess access);

[System.Obsolete("This constructor has been deprecated. Use FileStream(SafeFileHandle handle, FileAccess access) instead.")]
public FileStream (IntPtr handle, System.IO.FileAccess access);

public FileStream (IntPtr handle, System.IO.FileAccess access);

[System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access) instead.  http://go.microsoft.com/fwlink/?linkid=14202")]
public FileStream (IntPtr handle, System.IO.FileAccess access);

[System.Obsolete("Use FileStream(SafeFileHandle handle, FileAccess access) instead")]
public FileStream (IntPtr handle, System.IO.FileAccess access);

[<System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access) instead.  https://go.microsoft.com/fwlink/?linkid=14202")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess -> System.IO.FileStream

[<System.Obsolete("This constructor has been deprecated. Use FileStream(SafeFileHandle handle, FileAccess access) instead.")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess -> System.IO.FileStream

new System.IO.FileStream : nativeint * System.IO.FileAccess -> System.IO.FileStream

[<System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access) instead.  http://go.microsoft.com/fwlink/?linkid=14202")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess -> System.IO.FileStream

[<System.Obsolete("Use FileStream(SafeFileHandle handle, FileAccess access) instead")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess -> System.IO.FileStream

Public Sub New (handle As IntPtr, access As FileAccess)

Parameter

handle: IntPtr
nativeint

Ein Dateihandle für die Datei, die vom aktuellen FileStream-Objekt gekapselt wird.

access: FileAccess

Eine bitweise Kombination der Enumerationswerte, die die Eigenschaften CanRead und CanWrite des FileStream-Objekts festlegen.

Attribute: ObsoleteAttribute

Ausnahmen

ArgumentException

access ist kein Feld von FileAccess.

SecurityException

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

IOException

Ein E/A-Fehler, z. B. ein Datenträgerfehler, ist aufgetreten.

- oder -

Der Stream wurde geschlossen.

UnauthorizedAccessException

Hinweise

Wenn Close aufgerufen wird, wird das Handle ebenfalls geschlossen, und die Handleanzahl der Datei wird dekrementiert.

Achtung

FileShare.Read ist die Standardeinstellung für diese FileStream Konstruktoren ohne FileShare Parameter.

Eine Liste der allgemeinen Datei- und Verzeichnisvorgänge finden Sie unter Allgemeine E/A-Aufgaben.

Siehe auch

Gilt für: