FileStream.Handle Propiedad

Definición

Espacio de nombres:

System.IO

Ensamblados:

netstandard.dll, 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 para el archivo que el objeto actual 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 para el archivo encapsulado por este FileStream objeto o -1 si FileStream se ha cerrado .

Atributos

ObsoleteAttribute

Excepciones

SecurityException

El autor de la llamada no tiene el permiso necesario.

Comentarios

Esta propiedad es un identificador de sistema operativo para su uso con llamadas del sistema proporcionadas por el sistema operativo (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 superpuesto y requiere parámetros diferentes para ReadFile y WriteFile.

Precaución

Es posible que se produzcan daños en los datos si se crea un FileStream , se pasa su identificador, alguna operación mueve el puntero de archivo del identificador y, a continuación FileStream , se vuelve a usar . 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 un IOException si FileStream 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 podría 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