FileStream.Handle Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.IO
Zestaw:
System.Runtime.dll
Zestaw:
mscorlib.dll
Zestaw:
netstandard.dll

Przestroga

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

Przestroga

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

Przestroga

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

Przestroga

Use SafeFileHandle instead

Pobiera dojście do pliku systemu operacyjnego, który jest hermetyzowany przez bieżący FileStream obiekt.

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("Use SafeFileHandle 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")>]
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
[<System.Obsolete("Use SafeFileHandle instead")>]
member this.Handle : nativeint
Public Overridable ReadOnly Property Handle As IntPtr

Wartość właściwości

IntPtr

nativeint

Uchwyt pliku systemu operacyjnego dla pliku hermetyzowanego przez ten FileStream obiekt lub -1, jeśli FileStream plik został zamknięty.

Atrybuty
ObsoleteAttribute SecurityCriticalAttribute

Wyjątki

SecurityException

Obiekt wywołujący nie posiada wymaganych uprawnień.

Uwagi

Ta właściwość jest uchwytem systemu operacyjnego do użycia z wywołaniami systemu operacyjnego (takimi jak ReadFile w systemie Windows). Nie będzie działać z funkcjami biblioteki języka C, które oczekują deskryptora plików, na przykład fread.

Uchwyt systemu operacyjnego mógł zostać otwarty synchronicznie lub asynchronicznie, w zależności od tego, który FileStream konstruktor został wywołany. Użyj właściwości , IsAsync aby dowiedzieć się, czy ten uchwyt został otwarty asynchronicznie. W systemie Win32 oznacza to, że uchwyt został otwarty dla nakładających się operacji we/wy i wymaga różnych parametrów do ReadFile i WriteFile.

Przestroga

Uszkodzenie danych może wystąpić w przypadku utworzenia FileStream elementu, jego uchwyt jest przekazywany, operacja przenosi wskaźnik pliku dojścia, a następnie FileStream jest ponownie używany. Wiele wątków nie może bezpiecznie zapisywać w tym samym pliku jednocześnie, a FileStream kod buforowania zakłada, że steruje wyłącznie uchwytem. FileStream może zgłosić błąd IOException , jeśli FileStream wykryje, że jakiś inny proces przeniósł wskaźnik pliku. Aby tego uniknąć, nie zapisuj żadnych danych w części pliku, która FileStream mogła zostać buforowana, i przywróć wskaźnik pliku do lokalizacji, w jakiej miała miejsce, gdy metody były ostatnio wywoływane na FileStream.

Dotyczy

Zobacz też