FileStream-Konstruktor (IntPtr, FileAccess)

Artikel
08/20/2007

HINWEIS: Dieser Konstruktor ist mittlerweile veraltet.

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

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.  https://go.microsoft.com/fwlink/?linkid=14202")> _
Public Sub New ( _
    handle As IntPtr, _
    access As FileAccess _
)
'Usage
Dim handle As IntPtr
Dim access As FileAccess

Dim instance As New FileStream(handle, access)

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

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

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

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

Parameter

handle

access

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

Wenn Close aufgerufen wird, wird auch das Handle geschlossen und der Handlezähler der Datei verringert.

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.

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.

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.

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