FileStream.Handle-Eigenschaft

Artikel
08/20/2007

HINWEIS: Diese Eigenschaft ist mittlerweile veraltet.

Ruft das Dateihandle des Betriebssystems für die Datei ab, die durch das aktuelle FileStream-Objekt gekapselt wird.

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

Syntax

'Declaration
<ObsoleteAttribute("This property has been deprecated.  Please use FileStream's SafeFileHandle property instead.  https://go.microsoft.com/fwlink/?linkid=14202")> _
Public Overridable ReadOnly Property Handle As IntPtr
'Usage
Dim instance As FileStream
Dim value As IntPtr

value = instance.Handle

[ObsoleteAttribute("This property has been deprecated.  Please use FileStream\'s SafeFileHandle property instead.  https://go.microsoft.com/fwlink/?linkid=14202")] 
public virtual IntPtr Handle { get; }

[ObsoleteAttribute(L"This property has been deprecated.  Please use FileStream\'s SafeFileHandle property instead.  https://go.microsoft.com/fwlink/?linkid=14202")] 
public:
virtual property IntPtr Handle {
    IntPtr get ();
}

/** @property */
public IntPtr get_Handle ()

public function get Handle () : IntPtr

Eigenschaftenwert

Das Dateihandle des Betriebssystems für die vom FileStream-Objekt gekapselte Datei oder -1, wenn FileStream geschlossen wurde.

Ausnahmen

Ausnahmetyp	Bedingung
SecurityException	Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

Hinweise

Diese Eigenschaft ist ein Betriebssystemhandle für vom Betriebssystem bereitgestellte Systemaufrufe (wie ReadFile in Windows). Eine Verwendung mit Funktionen der C-Bibliothek, die einen Dateideskriptor erwarten, z. B. fread, ist nicht möglich.

Das Betriebssystemhandle kann abhängig vom aufgerufenen FileStream-Konstruktor synchron oder asynchron geöffnet worden sein. Ermitteln Sie mithilfe der IsAsync-Eigenschaft, ob dieses Handle asynchron geöffnet wurde. Bei Win32 bedeutet dies, dass das Handle für die überlappende E/A geöffnet wurde und andere Parameter für ReadFile und WriteFile erforderlich sind.

Warnung

Es können Datenverluste auftreten, wenn ein FileStream erstellt, das zugeordnete Handle übergeben, anschließend der Dateizeiger des Handles durch einen Vorgang verschoben und dann der FileStream erneut verwendet wird. Gleichzeitige Schreibvorgänge in der Datei durch mehrere Threads sind unsicher. Im Code für die Pufferung durch FileStream wird davon ausgegangen, dass dieser die exklusive Kontrolle über das Handle hat. FileStream löst möglicherweise eine IOException aus, wenn FileStream feststellt, dass der Dateizeiger durch einen anderen Prozess verschoben wurde. Dies lässt sich umgehen, indem Sie keine Daten in den Teil einer Datei schreiben, der möglicherweise durch FileStream gepuffert wurde, und den Dateizeiger an der Position wiederherstellen, die dieser vor dem letzten Aufrufen von Methoden in FileStream hatte.

.NET Framework-Sicherheit

SecurityPermission für das Aufrufen von verwaltetem Code, z. B. dem Aufrufen von systemeigenem Code mit PInvoke oder COM-Integration. Zugeordnete Enumeration: SecurityPermissionFlag.UnmanagedCode

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, 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