FileStream.Handle Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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 : 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 IntPtrHodnota vlastnosti
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.
