Sdílet prostřednictvím


FileStream.Handle Vlastnost

Definice

Upozornění

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

Upozornění

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

Upozornění

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

Získá popisovač souboru operačního systému pro soubor, který aktuální FileStream objekt zapouzdřuje.

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

Hodnota vlastnosti

IntPtr

nativeint

Popisovač souboru operačního systému pro soubor zapouzdřený tímto FileStream objektem, nebo -1, pokud FileStream byl uzavřen.

Atributy

Výjimky

Volající nemá požadované oprávnění.

Poznámky

Tato vlastnost je popisovač operačního systému pro použití se systémovými voláními poskytovanými operačním systémem (například ReadFile ve Windows). Nebude fungovat s funkcemi knihovny jazyka C, které očekávají popisovač souborů, například fread.

Popisovač operačního systému mohl být otevřen synchronně nebo asynchronně v závislosti na tom, který FileStream konstruktor byl volán. IsAsync Pomocí vlastnosti zjistěte, zda byl tento popisovač otevřen asynchronně. Ve Win32 to znamená, že popisovač byl otevřen pro překrývající se vstupně-výstupní operace a vyžaduje různé parametry pro ReadFile a WriteFile.

Upozornění

K poškození dat může dojít, pokud FileStream se vytvoří, předá se jeho popisovač, některá operace přesune ukazatel souboru popisovače a pak FileStream se znovu použije. Více vláken nemůže bezpečně zapisovat do stejného souboru současně a FileStream kód ve vyrovnávací paměti předpokládá, že výhradně řídí popisovač. FileStream může vyvolat chybu IOException , pokud FileStream zjistí, že ukazatel na soubor přesunul jiný proces. Chcete-li se tomu vyhnout, nezapisujte žádná data do části souboru, která FileStream by mohla být uložena do vyrovnávací paměti, a obnovte ukazatel na soubor do umístění, které měl při posledním vyvolání metod na FileStream.

Platí pro

Viz také