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í
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. https://go.microsoft.com/fwlink/?linkid=14202
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("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 IntPtrHodnota vlastnosti
nativeint
Popisovač souboru operačního systému pro soubor zapouzdřený tímto FileStream objektem nebo -1, pokud FileStream byl zavř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í s voláními systému 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 můžete zjistit, zda byl tento popisovač otevřen asynchronně. V systému 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 je vytvořen, jeho popisovač se předá, 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 ukládání do vyrovnávací paměti předpokládá, že řídí výhradně popisovač.
FileStream může vyvolat chybu IOException , pokud FileStream zjistí, že některý jiný proces přesunul ukazatel souboru. Abyste tomu předešli, nezapisujte žádná data do části souboru, která FileStream by mohla být uložena do vyrovnávací paměti, a obnovte ukazatel souboru do umístění, které měl, když metody byly naposledy volány FileStream.
