Exportar (0) Imprimir
Expandir todo

SafeHandle.ReleaseHandle (Método)

Nota: este método es nuevo en la versión 2.0 de .NET Framework.

Cuando se reemplaza en una clase derivada, ejecuta el código necesario para liberar el identificador.

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

protected abstract bool ReleaseHandle ()
protected abstract boolean ReleaseHandle ()
protected abstract function ReleaseHandle () : boolean

Valor devuelto

true si se libera el identificador correctamente; de lo contrario, en caso de un grave error, false. En este caso, genera un Ayudante para la depuración administrada ReleaseHandleFailed.

Se garantiza que sólo se va a llamar una vez al método ReleaseHandle y sólo si el identificador es válido como se define con la propiedad IsInvalid. Implemente este método en sus clases derivadas SafeHandle para ejecutar el código que sea necesario para liberar el identificador. Dado que una de las funciones de SafeHandle es garantizar la prevención de la falta de recursos, el código de la implementación de ReleaseHandle nunca debe producir un error. El recolector de elementos no utilizados llama al método ReleaseHandle después de que se han ejecutado los finalizadores normales para objetos que el recolector de elementos no utilizados ha recolectado a la vez y garantiza que los recursos lo invocan y que no se interrumpirá cuando está en progreso. Se preparará este método como una región de ejecución limitada (CER) en el momento de la construcción de la instancia (junto con todos los métodos en su gráfico de llamadas determinable estáticamente). Aunque esto evita las interrupciones de anulación de subproceso, aún debe procurar no introducir ninguna ruta de acceso con error en el método ReleaseHandle reemplazado. En particular, aplique el atributo ReliabilityContractAttribute a los métodos a los que llame desde ReleaseHandle. En la mayoría de los casos este código debería ser:

ReliabilityContract(Consistency.WillNotCorruptState, Cer.Success)

De forma adicional, para la limpieza sencilla (por ejemplo, si se llama a la API Win32 CloseHandle en un identificador de archivos) puede comprobar el valor devuelto de la llamada de invocación de plataforma única. Para la limpieza compleja, podría tener mucha lógica de programa y muchas llamadas a método, que podrían producir un error. Debe garantizar que la lógica de programa tenga el código de reserva para cada uno de esos casos.

Si el método ReleaseHandle devuelve false por algún motivo, se genera un Ayudante de depuración administrada ReleaseHandleFailed. Esto le ayuda a detectar los casos en que intenta liberar las faltas de recursos.

En el ejemplo de código siguiente se muestra cómo se implementa la clase SafeHandle.

[DllImport("kernel32")]
[ReliabilityContract(Consistency.WillNotCorruptState, Cer.Success)]
private static extern bool CloseHandle(IntPtr handle);

protected override bool ReleaseHandle()
{
    return CloseHandle(handle);
}

Windows 98, Windows 2000 SP4, Windows Millennium, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition

.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.

.NET Framework

Compatible con: 2.0

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft