SafeHandle.IsInvalid Свойство

Определение

При переопределении в производном классе получает значение, показывающее, допустимо ли значение дескриптора.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

Значение свойства

Значение true, если значение дескриптора является неправильным; в противном случае — значение false.true if the handle value is invalid; otherwise, false.

Примеры

В следующем примере проверяется, успешно ли открыт файл.The following example checks if a file was opened successfully. Этот пример кода является частью большого примера, SafeHandle приведенного для класса.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);

Комментарии

Производные классы должны реализовывать IsInvalid свойство, чтобы среда CLR могла определить, требуется ли критическая финализация.Derived classes must implement the IsInvalid property so that the common language runtime can determine whether critical finalization is required. Производные классы должны предоставлять реализацию, соответствующую общему типу поддерживаемых им обработчиков (0 или-1 является недопустимым).Derived classes must provide an implementation that suits the general type of handle they support (0 or -1 is invalid). Затем эти классы можно сделать производными для конкретных типов безопасного обработчика.These classes can then be further derived for specific safe handle types.

В SafeHandle IsClosed отличиеотсвойства,котороесообщает,завершилсялиобъектспомощьюбазовогомаркера,свойствовычисляет,всегдасчитаетсялизначениеданногообработчикаIsInvalid недопустимым.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. Таким образом, IsInvalid свойство всегда возвращает одно и то же значение для любого значения обработчика.Therefore, the IsInvalid property always returns the same value for any one handle value.

Безопасность

SecurityPermission
разрешение на вызов неуправляемого кода.for permission to call unmanaged code. Действие по обеспечению безопасности: LinkDemand.Security action: LinkDemand. Связанное перечисление:UnmanagedCodeAssociated enumeration: UnmanagedCode

Применяется к