SafeHandle.IsInvalid Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Cuando se invalida en una clase derivada, obtiene un valor que indica si este identificador es no válido.
public:
abstract property bool IsInvalid { bool get(); };public abstract bool IsInvalid { get; }member this.IsInvalid : boolPublic MustOverride ReadOnly Property IsInvalid As BooleanValor de propiedad
true si el valor del identificador no es válido; en caso contrario, false.
Ejemplos
En el ejemplo siguiente se comprueba si un archivo se abrió correctamente. Este ejemplo de código es parte de un ejemplo más grande proporcionado para la clase SafeHandle.
// Determine if file is opened successfully.
if (_handle.IsInvalid)
throw new Win32Exception(Marshal.GetLastWin32Error(), fileName);
Comentarios
Las clases derivadas deben implementar la IsInvalid propiedad para que Common Language Runtime pueda determinar si se requiere la finalización crítica. Las clases derivadas deben proporcionar una implementación que se adapte al tipo general de identificador que admiten (0 o -1 no es válido). A continuación, estas clases se pueden derivar aún más para tipos de identificadores seguros específicos.
A diferencia de la IsClosed propiedad , que indica si el SafeHandle objeto ha terminado de usar el identificador subyacente, la IsInvalid propiedad calcula si el valor del identificador especificado siempre se considera no válido. Por lo tanto, la IsInvalid propiedad siempre devuelve el mismo valor para cualquier valor de identificador.
