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
FileStream.Handle has been deprecated. Use FileStream's SafeFileHandle property instead.
Achtung
This property has been deprecated. Please use FileStream's SafeFileHandle property instead. https://go.microsoft.com/fwlink/?linkid=14202
Achtung
This property has been deprecated. Please use FileStream's SafeFileHandle property instead. http://go.microsoft.com/fwlink/?linkid=14202
Ruft das Betriebssystemdateihandle für die Datei ab, die das aktuelle FileStream Objekt kapselt.
public:
virtual property IntPtr Handle { IntPtr 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. https://go.microsoft.com/fwlink/?linkid=14202")]
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("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. https://go.microsoft.com/fwlink/?linkid=14202")>]
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 Betriebssystemdateihandle für die Datei, die von diesem FileStream Objekt gekapselt wurde, oder -1, wenn die FileStream Datei 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). Es funktioniert nicht mit C-Bibliotheksfunktionen, die einen Dateideskriptor erwarten, z fread. B. .
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 der Handle für überlappende E/A geöffnet wurde, und es erfordert unterschiedliche Parameter und ReadFileWriteFile.
Vorsicht
Datenbeschädigungen können auftreten, wenn ein FileStream Erstellter erstellt wird, sein Handle übergeben wird, einige Vorgänge verschiebt den Dateizeiger des Handles und dann FileStream erneut verwendet. Mehrere Threads können nicht gleichzeitig in dieselbe Datei schreiben, und FileStream der Puffercode geht davon aus, dass er ausschließlich das Handle steuert.
FileStream wird möglicherweise ausgelöst IOException , wenn FileStream erkannt wird, dass ein anderer Prozess den Dateizeiger verschoben hat. Um dies zu vermeiden, schreiben Sie keine Daten in einen Teil der Datei, FileStream die möglicherweise gepuffert wurde, und stellen Sie den Dateizeiger auf den Speicherort zurück, an dem sie beim letzten Aufruf der Methoden vorhanden FileStreamwar.
