FileStream.Handle Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 : nativeintmember 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 : nativeintPublic Overridable ReadOnly Property Handle As IntPtrEigenschaftswert
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.
