FileStream.Handle Propiedad

Definición

Espacio de nombres:

System.IO

Ensamblado:

System.Runtime.dll

Source:

FileStream.cs

Precaución

FileStream.Handle has been deprecated. Use FileStream's SafeFileHandle property instead.

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("FileStream.Handle has been deprecated. Use FileStream's SafeFileHandle property instead.")]
public virtual IntPtr Handle { get; }

[<System.Obsolete("FileStream.Handle has been deprecated. Use FileStream's SafeFileHandle property instead.")>]
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

ObsoleteAttribute

Excepciones

SecurityException

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.

Consulte también

• E/S de archivos y secuencias
• Cómo: Leer texto de un archivo
• Cómo: Escribir texto en un archivo