SafeHandle.IsInvalid Propriedade

Definição

Quando substituído em uma classe derivada, obtém um valor que indica se o valor de indicador é 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 da propriedade

Boolean

true Se o valor do identificador for inválido; caso contrário, false .true if the handle value is invalid; otherwise, false.

Exemplos

O exemplo a seguir verifica se um arquivo foi aberto com êxito.The following example checks if a file was opened successfully. Este exemplo de código faz parte de um exemplo maior fornecido para a SafeHandle classe.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);

Comentários

Classes derivadas devem implementar a IsInvalid propriedade para que a Common Language Runtime possa determinar se a finalização crítica é necessária.Derived classes must implement the IsInvalid property so that the common language runtime can determine whether critical finalization is required. As classes derivadas devem fornecer uma implementação que atenda ao tipo geral de identificador ao qual dão suporte (0 ou-1 é inválido).Derived classes must provide an implementation that suits the general type of handle they support (0 or -1 is invalid). Essas classes podem então ser derivadas posteriormente para tipos específicos de identificadores seguros.These classes can then be further derived for specific safe handle types.

Ao contrário da IsClosed propriedade, que relata se o SafeHandle objeto terminou de usar o identificador subjacente, a IsInvalid Propriedade calcula se o valor de identificador fornecido é sempre considerado invá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. Portanto, a IsInvalid propriedade sempre retorna o mesmo valor para qualquer valor de identificador.Therefore, the IsInvalid property always returns the same value for any one handle value.

Aplica-se a