FileStream.Handle Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Let op
This property has been deprecated. Please use FileStream's SafeFileHandle property instead. http://go.microsoft.com/fwlink/?linkid=14202
Let op
This property has been deprecated. Please use FileStream's SafeFileHandle property instead. https://go.microsoft.com/fwlink/?linkid=14202
Hiermee haalt u de bestandsgreep van het besturingssysteem op voor het bestand dat het huidige FileStream object inkapselt.
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 : nativeintPublic Overridable ReadOnly Property Handle As IntPtrWaarde van eigenschap
nativeint
De bestandsgreep van het besturingssysteem voor het bestand dat door dit FileStream object is ingekapseld, of -1 als het FileStream is gesloten.
- Kenmerken
Uitzonderingen
De beller heeft niet de vereiste machtiging.
Opmerkingen
Deze eigenschap is een besturingssysteemhandgreep voor gebruik met systeemaanroepen van het besturingssysteem (zoals ReadFile op Windows). Het werkt niet met C-bibliotheekfuncties die een bestandsdescriptor verwachten, zoals fread.
De ingang van het besturingssysteem is mogelijk synchroon of asynchroon geopend, afhankelijk van de FileStream constructor die is aangeroepen. Gebruik de IsAsync eigenschap om te ontdekken of deze ingang asynchroon is geopend. In Win32 betekent dit dat de ingang is geopend voor overlappende I/O en dat hiervoor verschillende parameters zijn vereist voor ReadFile en WriteFile.
Caution
Gegevensbeschadiging kan optreden als er een FileStream is gemaakt, de greep wordt doorgegeven, een bepaalde bewerking verplaatst de bestandswijzer van de handle en vervolgens wordt het FileStream opnieuw gebruikt. Meerdere threads kunnen niet veilig tegelijk naar hetzelfde bestand schrijven en FileStream bij het bufferen van code wordt ervan uitgegaan dat deze uitsluitend de ingang beheert.
FileStream kan een IOException fout opleveren als FileStream wordt gedetecteerd dat een ander proces de bestandsaanwijzer heeft verplaatst. Om dit te voorkomen, schrijft u geen gegevens naar een deel van het bestand dat FileStream mogelijk is gebufferd en herstelt u de bestandswijzer naar de locatie waarop de methoden voor het laatst werden aangeroepen FileStream.