Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

FileStream.Handle (Propiedad)

 
Nota: esta API está ahora 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 {
	[SecurityCriticalAttribute]
	[SecurityPermissionAttribute(SecurityAction.InheritanceDemand, 
		Flags = SecurityPermissionFlag.UnmanagedCode)]
	get;
}

Valor de propiedad

Type: System.IntPtr

Identificador de archivo del sistema operativo correspondiente al archivo encapsulado por este objeto FileStream o -1 si se ha cerrado FileStream.

Exception Condition
SecurityException

El llamador no dispone del permiso requerido.

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

El identificador del sistema operativo puede haber sido abierto forma sincrónica o asincrónica, dependiendo de qué FileStream se llamó el constructor. Utilice la IsAsync propiedad 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.

System_CAPS_cautionPrecaución

Pueden producirse daños en los datos si un FileStream está creado, se pasa su identificador, alguna operación mueve el puntero de archivo del controlador y, a continuación, el FileStream se utiliza de nuevo. Varios subprocesos no pueden escribir sin ningún riesgo al mismo archivo simultáneamente, y FileStream el código de búfer se supone que lo controla el controlador exclusivamente. FileStream podría producir un IOException Si FileStream detecta que algún otro proceso ha movido el puntero de archivo. Para evitarlo, escriba ningún dato en ninguna parte del archivo que FileStream posible que haya almacenado en búfer y restaurar el puntero de archivo en la ubicación que tenía cuando se llamó por última métodos en FileStream.

SecurityPermission

for the ability to access unmanaged code. Associated enumeration: F:System.Security.Permissions.SecurityPermissionFlag.UnmanagedCode Security action: F:System.Security.Permissions.SecurityAction.LinkDemand.

SecurityPermission

for the ability to access unmanaged code. Associated enumeration: F:System.Security.Permissions.SecurityPermissionFlag.UnmanagedCode Security action: F:System.Security.Permissions.SecurityAction.InheritanceDemand.

SecurityCriticalAttribute

requires full trust for the immediate caller. This member cannot be used by partially trusted or transparent code.

.NET Framework
Disponible desde 1.1
Volver al principio
Mostrar: