Teilen über


FileStream.Handle Eigenschaft

Definition

Achtung

This property has been deprecated. Please use FileStream's SafeFileHandle property instead. https://go.microsoft.com/fwlink/?linkid=14202

Achtung

FileStream.Handle has been deprecated. Use FileStream's SafeFileHandle property instead.

Achtung

This property has been deprecated. Please use FileStream's SafeFileHandle property instead. http://go.microsoft.com/fwlink/?linkid=14202

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

public:
 virtual property IntPtr Handle { IntPtr get(); };
[System.Obsolete("This property has been deprecated.  Please use FileStream's SafeFileHandle property instead.  https://go.microsoft.com/fwlink/?linkid=14202")]
public virtual IntPtr Handle { get; }
[System.Obsolete("FileStream.Handle has been deprecated. Use FileStream's SafeFileHandle property instead.")]
public virtual IntPtr Handle { get; }
[System.Obsolete("This property has been deprecated.  Please use FileStream's SafeFileHandle property instead.  http://go.microsoft.com/fwlink/?linkid=14202")]
public virtual IntPtr Handle { get; }
public virtual IntPtr Handle { get; }
[System.Obsolete("This property has been deprecated.  Please use FileStream's SafeFileHandle property instead.  http://go.microsoft.com/fwlink/?linkid=14202")]
public virtual IntPtr Handle { [System.Security.SecurityCritical] get; }
[<System.Obsolete("This property has been deprecated.  Please use FileStream's SafeFileHandle property instead.  https://go.microsoft.com/fwlink/?linkid=14202")>]
member this.Handle : nativeint
[<System.Obsolete("FileStream.Handle has been deprecated. Use FileStream's SafeFileHandle property instead.")>]
member this.Handle : nativeint
[<System.Obsolete("This property has been deprecated.  Please use FileStream's SafeFileHandle property instead.  http://go.microsoft.com/fwlink/?linkid=14202")>]
member this.Handle : nativeint
member this.Handle : nativeint
[<System.Obsolete("This property has been deprecated.  Please use FileStream's SafeFileHandle property instead.  http://go.microsoft.com/fwlink/?linkid=14202")>]
[<get: System.Security.SecurityCritical>]
member this.Handle : nativeint
Public Overridable ReadOnly Property Handle As IntPtr

Eigenschaftswert

IntPtr

nativeint

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

Attribute

Ausnahmen

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

Hinweise

Diese Eigenschaft ist ein Betriebssystemhandle für die Verwendung mit vom Betriebssystem bereitgestellten Systemaufrufen (z ReadFile . B. unter Windows). Sie funktioniert nicht mit C-Bibliotheksfunktionen, die einen Dateideskriptor freadwie erwarten.

Je nachdem, welcher FileStream Konstruktor aufgerufen wurde, wurde das Betriebssystemhandle möglicherweise synchron oder asynchron geöffnet. Verwenden Sie die IsAsync -Eigenschaft, um zu ermitteln, ob dieses Handle asynchron geöffnet wurde. In Win32 bedeutet dies, dass das Handle für überlappende E/A geöffnet wurde und unterschiedliche Parameter für ReadFile und WriteFileerfordert.

Achtung

Eine Datenbeschädigung kann auftreten, wenn ein FileStream erstellt wird, dessen Handle übergeben wird, bei einem vorgang der Dateizeiger des Handles verschoben wird und dann FileStream erneut verwendet wird. Mehrere Threads können nicht gleichzeitig sicher in dieselbe Datei schreiben, und FileStream beim Puffern von Code wird davon ausgegangen, dass er ausschließlich das Handle steuert. FileStream wird möglicherweise ausgelöst IOException , wenn FileStream erkannt wird, dass der Dateizeiger von einem anderen Prozess verschoben wurde. Um dies zu vermeiden, schreiben Sie keine Daten in einen Teil der Datei, FileStream der möglicherweise gepuffert wurde, und stellen Sie den Dateizeiger auf den Speicherort wieder her, an dem die Methoden zuletzt aufgerufen FileStreamwurden.

Gilt für:

Weitere Informationen