Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

FileStream.Handle (Propiedad)

Nota: esta API ya está obsoleta.

Obtiene el identificador de archivo del sistema operativo correspondiente al archivo que el objeto FileStream encapsula.

Espacio de nombres:  System.IO
Ensamblado:  mscorlib (en mscorlib.dll)

[ObsoleteAttribute("This property has been deprecated.  Please use FileStream's SafeFileHandle property instead.  http://go.microsoft.com/fwlink/?linkid=14202")]
public virtual IntPtr Handle { get; }

Valor de propiedad

Tipo: System.IntPtr
El identificador de archivo del sistema operativo correspondiente al archivo encapsulado por este objeto FileStream o -1 si se ha cerrado FileStream.

ExcepciónCondición
SecurityException

El llamador no dispone del permiso requerido.

Esta propiedad es un identificador del sistema operativo para su uso con llamadas de sistema proporcionadas por el sistema operativo (como ReadFile en Windows). No funcionará con funciones de biblioteca C que esperan un descriptor de acceso de archivo, como fread.

Es posible que se haya abierto el identificador del sistema operativo de forma sincrónica o asincrónica, dependiendo del constructor FileStream al que se llamó. Utilice la propiedad IsAsync para detectar si se abrió este identificador de forma asincrónica. En Win32, esto significa que se abrió el identificador para la E/S superpuesta y que requiere parámetros distintos a ReadFile y WriteFile.

Nota de precauciónPrecaución

Es posible que los datos resulten dañados si se crea un FileStream, se pasa su identificador, alguna operación mueve el puntero de archivo del identificador y, a continuación, se utiliza de nuevo FileStream. Varios subprocesos no pueden escribir sin ningún riesgo simultáneamente en el mismo archivo y el código de búfer FileStream supone que controla el controlador exclusivamente. FileStream podrían producir un IOException si FileStream detecta que algún otro proceso ha movido el puntero de archivo. Para impedirlo, no escriba ningún dato en ninguna parte del archivo que FileStream pueda haber almacenado en el búfer y vuelva a restaurar el puntero de archivo en la ubicación que tenía cuando se llamó a los métodos en FileStream por última vez.

.NET Framework

Compatible con: 1.1, 1.0
Obsoleto (advertencia del compilador) en 4.5
Obsoleto (advertencia del compilador) en 4
Obsoleto (advertencia del compilador) en 3.5
Obsoleto (advertencia del compilador) en 3.5 SP1
Obsoleto (advertencia del compilador) en 3.0
Obsoleto (advertencia del compilador) en 3.0 SP1
Obsoleto (advertencia del compilador) en 3.0 SP2
Obsoleto (advertencia del compilador) en 2.0
Obsoleto (advertencia del compilador) en 2.0 SP1
Obsoleto (advertencia del compilador) en 2.0 SP2

.NET Framework Client Profile

Obsoleto (advertencia del compilador) en 4
Obsoleto (advertencia del compilador) en 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft