FileStream.Handle Egenskap

Definition

Namnområde:
System.IO
Sammansättning:
mscorlib.dll
Sammansättning:
netstandard.dll

Varning

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

Varning

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

Hämtar operativsystemets filhandtag för filen som det aktuella FileStream objektet kapslar in.

public:
 virtual property IntPtr Handle { IntPtr 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 { 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")]
public virtual IntPtr Handle { get; }
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
[<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
[<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
Public Overridable ReadOnly Property Handle As IntPtr

Egenskapsvärde

IntPtr

nativeint

Filhandtaget för operativsystemet för filen som kapslas in av det här FileStream objektet eller -1 om den FileStream har stängts.

Attribut
ObsoleteAttribute SecurityCriticalAttribute

Undantag

SecurityException

Anroparen har inte den behörighet som krävs.

Kommentarer

Den här egenskapen är ett operativsystemreferens för användning med systemanrop som tillhandahålls av operativsystemet (till exempel ReadFile på Windows). Det fungerar inte med C-biblioteksfunktioner som förväntar sig en filbeskrivning, till exempel fread.

Operativsystemets handtag kan ha öppnats synkront eller asynkront, beroende på vilken konstruktor som FileStream anropades. Använd egenskapen IsAsync för att ta reda på om det här handtaget öppnades asynkront. I Win32 innebär det att handtaget öppnades för överlappande I/O och att det kräver olika parametrar till ReadFile och WriteFile.

Caution

Dataskada kan inträffa om en FileStream skapas, dess handtag skickas, en åtgärd flyttar handtagets filpekare och sedan används den FileStream igen. Flera trådar kan inte skriva till samma fil samtidigt på ett säkert sätt, och FileStream buffringskoden förutsätter att den endast styr handtaget. FileStream kan utlösa en IOException om FileStream upptäcker att någon annan process har flyttat filpekaren. Undvik detta genom att inte skriva några data till en del av filen som FileStream kan ha buffrats och återställa filpekaren till den plats som den hade när metoderna senast anropades på FileStream.

Gäller för

Se även