SafeHandle.IsInvalid Propiedad

Definición

Cuando se invalida en una clase derivada, obtiene un valor que indica si este identificador es no válido.When overridden in a derived class, gets a value indicating whether the handle value is invalid.

public:
 abstract property bool IsInvalid { bool get(); };
public abstract bool IsInvalid { get; }
member this.IsInvalid : bool
Public MustOverride ReadOnly Property IsInvalid As Boolean

Valor de propiedad

Es true si el identificador no es válido; en caso contrario, es false.true if the handle value is invalid; otherwise, false.

Ejemplos

En el siguiente ejemplo se comprueba si un archivo se abrió correctamente.The following example checks if a file was opened successfully. Este ejemplo de código forma parte de un ejemplo más extenso proporcionado SafeHandle para la clase.This code example is part of a larger example provided for the SafeHandle class.

// Determine if file is opened successfully.
if (_handle.IsInvalid)
    throw new Win32Exception(Marshal.GetLastWin32Error(), fileName);

Comentarios

Las clases derivadas deben IsInvalid implementar la propiedad para que el Common Language Runtime pueda determinar si se requiere la finalización crítica.Derived classes must implement the IsInvalid property so that the common language runtime can determine whether critical finalization is required. Las clases derivadas deben proporcionar una implementación que se adapte al tipo general de identificador admitido (0 o-1 no es válido).Derived classes must provide an implementation that suits the general type of handle they support (0 or -1 is invalid). Después, estas clases se pueden derivar más para tipos de controladores seguros específicos.These classes can then be further derived for specific safe handle types.

A diferencia de IsClosed la propiedad, que indica si SafeHandle el objeto ha terminado de usar el identificador subyacente IsInvalid , la propiedad calcula si el valor de identificador especificado siempre se considera no válido.Unlike the IsClosed property, which reports whether the SafeHandle object has finished using the underlying handle, the IsInvalid property calculates whether the given handle value is always considered invalid. Por lo tanto IsInvalid , la propiedad siempre devuelve el mismo valor para cualquier valor de identificador.Therefore, the IsInvalid property always returns the same value for any one handle value.

Seguridad

SecurityPermission
para obtener permiso para llamar a código no administrado.for permission to call unmanaged code. Acción de seguridad LinkDemand:.Security action: LinkDemand. Enumeración asociada:UnmanagedCodeAssociated enumeration: UnmanagedCode

Se aplica a