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

HINWEIS: Dieser Konstruktor ist mittlerweile 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.

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

Syntax

'Declaration
<ObsoleteAttribute("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 Sub New ( _
    handle As IntPtr, _
    access As FileAccess, _
    ownsHandle As Boolean, _
    bufferSize As Integer, _
    isAsync As Boolean _
)
'Usage
Dim handle As IntPtr
Dim access As FileAccess
Dim ownsHandle As Boolean
Dim bufferSize As Integer
Dim isAsync As Boolean

Dim instance As New FileStream(handle, access, ownsHandle, bufferSize, isAsync)

[ObsoleteAttribute("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,
    FileAccess access,
    bool ownsHandle,
    int bufferSize,
    bool isAsync
)

[ObsoleteAttribute(L"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, 
    FileAccess access, 
    bool ownsHandle, 
    int bufferSize, 
    bool isAsync
)

/** @attribute ObsoleteAttribute("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, 
    FileAccess access, 
    boolean ownsHandle, 
    int bufferSize, 
    boolean isAsync
)

ObsoleteAttribute("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 function FileStream (
    handle : IntPtr, 
    access : FileAccess, 
    ownsHandle : boolean, 
    bufferSize : int, 
    isAsync : boolean
)

Parameter

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

• access
  Eine FileAccess-Konstante, die die CanRead-Eigenschaft und die CanWrite-Eigenschaft des FileStream-Objekts abruft.

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

• bufferSize
  Ein positiver Int32-Wert größer als 0 (null), der die Puffergröße angibt.

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

Ausnahmen

Hinweise

Dem FileStream-Objekt wird der angegebene Dateizugriff gewährt. Der Besitz des Handles entspricht den Angaben. Wenn dieser FileStream im Besitz des Handles ist, wird durch den Aufruf der Close-Methode auch das Handle geschlossen. Es wird auch der Handlezähler der Datei verringert. Dem FileStream-Objekt wird die angegebene Puffergröße zugewiesen.

Bei FileStream wird davon ausgegangen, dass dieser über die exklusive Kontrolle des Handles verfügt. Lese-, Schreib- oder Suchvorgänge während der gleichzeitigen Verwendung eines Handles durch einen FileStream können zu Datenverlusten führen. Rufen Sie für eine höhere Datensicherheit Flush auf, bevor Sie das Handle verwenden, und rufen Sie nach dem Verwenden des Handles keine andere Methode als Close auf. Sie können die Lese- und Schreibvorgänge am Handle jedoch auch vor dem Aufruf dieses FileStream-Konstruktors vornehmen.

FileShare.Read ist der Standard für FileStream-Konstruktoren ohne FileShare-Parameter.

In der folgenden Tabelle sind Beispiele für andere typische oder verwandte E/A-Aufgaben aufgeführt.

.NET Framework-Sicherheit

• SecurityPermission  für den Zugriff auf nicht verwalteten Code. Zugeordnete Enumeration: SecurityPermissionFlag.UnmanagedCode

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

Versionsinformationen

.NET Framework

Unterstützt in: 1.0, 1.1
Veraltet (Compilerwarnung) in 2.0

Siehe auch

Referenz

FileStream-Klasse
FileStream-Member
System.IO-Namespace

Weitere Ressourcen

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