FileStream-Konstruktor (IntPtr, FileAccess, Boolean)

Artikel
08/20/2007

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 und für den Besitz der FileStream-Instanz.

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

Syntax

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

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

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

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

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

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

Parameter

handle
Ein Dateihandle für die Datei, die vom aktuellen 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.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentException	access ist kein Feld von FileAccess.
SecurityException	Der Aufrufer verfügt nicht über die erforderliche Berechtigung.
IOException	Es ist ein E/A-Fehler aufgetreten, beispielsweise ein Datenträgerfehler. - oder - Der Stream wurde geschlossen.
UnauthorizedAccessException	Der angeforderte access für das angegebene Dateihandle wird durch das Betriebssystem nicht zugelassen. Dies ist z. B. der Fall, wenn Write oder ReadWrite für access festgelegt sind und das Dateihandle auf schreibgeschützten Zugriff festgelegt ist.

Hinweise

Dem FileStream-Objekt wird der angegebene Dateizugriff gewährt. Der Besitz des Handles entspricht den Angaben. Wenn der Prozess das Handle besitzt, wird durch einen Aufruf der Close-Methode auch das Handle geschlossen und der Handlezähler der Datei verringert. Das FileStream-Objekt erhält die Standardpuffergröße von 8.192 Bytes.

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.

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

Warnung

Wenn Sie einen Zeichensatz mit einer bestimmten Kultureinstellung kompilieren und die gleichen Zeichen mit einer anderen Kultureinstellung abrufen, können diese möglicherweise nicht interpretiert werden, und es wird eine Ausnahme ausgelöst.

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

Aufgabe	Beispiel in diesem Thema
Erstellen einer Textdatei.	Gewusst wie: Schreiben von Text in eine Datei
In eine Textdatei schreiben.	Gewusst wie: Schreiben von Text in eine Datei
Aus einer Textdatei lesen.	Gewusst wie: Lesen aus einer Textdatei
Text an eine Datei anfügen.	Gewusst wie: Öffnen und Anfügen an eine Protokolldatei File.AppendText FileInfo.AppendText
Eine Datei umbenennen oder verschieben.	File.Move FileInfo.MoveTo
Eine Datei löschen.	File.Delete FileInfo.Delete
Eine Datei kopieren.	File.Copy FileInfo.CopyTo
Die Größe einer Datei abrufen.	FileInfo.Length
Die Attribute einer Datei abrufen.	File.GetAttributes
Die Attribute einer Datei festlegen.	File.SetAttributes
Bestimmen, ob eine Datei vorhanden ist.	File.Exists
Aus einer Binärdatei lesen.	Gewusst wie: Lesen und Schreiben einer neu erstellten Datendatei
In eine Binärdatei schreiben.	Gewusst wie: Lesen und Schreiben einer neu erstellten Datendatei
Eine Dateierweiterung abrufen.	Path.GetExtension
Den vollqualifizierten Pfad einer Datei abrufen.	Path.GetFullPath
Den Dateinamen sowie die Dateierweiterung aus einem Pfad abrufen.	Path.GetFileName
Die Erweiterung einer Datei ändern.	Path.ChangeExtension

.NET Framework-Sicherheit

FileIOPermission für das Lesen, Schreiben und Anfügen von Dateien. Zugeordnete Enumerationen: FileIOPermissionAccess.Read, FileIOPermissionAccess.Write und FileIOPermissionAccess.Append.

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

Freigeben über