FileStream.Handle Propiedad

Definición

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 : 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

Valor de propiedad

IntPtr

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.

Se aplica a

Consulte también