FileStream.Handle Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Precaución
This property has been deprecated. Please use FileStream's SafeFileHandle property instead. https://go.microsoft.com/fwlink/?linkid=14202
Precaución
FileStream.Handle has been deprecated. Use FileStream's SafeFileHandle property instead.
Precaución
This property has been deprecated. Please use FileStream's SafeFileHandle property instead. http://go.microsoft.com/fwlink/?linkid=14202
Obtiene el identificador de archivo del sistema operativo correspondiente al archivo que el objeto FileStream encapsula.
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 IntPtrValor de propiedad
nativeint
Identificador de archivo del sistema operativo correspondiente al archivo encapsulado por este objeto FileStream o -1 si se ha cerrado FileStream.
- Atributos
Excepciones
El llamador no dispone del permiso requerido.
Comentarios
Esta propiedad es un identificador del sistema operativo para su uso con llamadas del sistema operativo proporcionadas por el sistema (como ReadFile en Windows). No funcionará con funciones de biblioteca de C que esperan un descriptor de archivo, como fread.
Es posible que el identificador del sistema operativo se haya abierto de forma sincrónica o asincrónica, en función del constructor al que FileStream se llamó. Use la IsAsync propiedad para detectar si este identificador se abrió de forma asincrónica. En Win32, esto significa que el identificador se abrió para E/S superpuesta y requiere parámetros diferentes para ReadFile y WriteFile.
Precaución
Los datos dañados pueden producirse si se crea un FileStream , se pasa su identificador, alguna operación mueve el puntero de archivo del identificador y, a continuación, se usa de FileStream nuevo. Varios subprocesos no pueden escribir de forma segura en el mismo archivo simultáneamente y FileStream el código de almacenamiento en búfer supone que controla exclusivamente el identificador. FileStream podría producir si IOExceptionFileStream detecta que algún otro proceso ha movido el puntero de archivo. Para evitar esto, no escriba ningún dato en una parte del archivo que FileStream pueda haber almacenado en búfer y restaure el puntero de archivo a la ubicación que tenía cuando se llamó por última vez a los métodos en FileStream.
