SafeHandle.IsInvalid Özellik

Tanım

Ad Alanı:

System.Runtime.InteropServices

Bütünleştirilmiş Kod:

System.Runtime.dll

Kaynak:

SafeHandle.cs

Türetilmiş bir sınıfta geçersiz kılındığında, tanıtıcı değerinin geçersiz olup olmadığını belirten bir değer alır.

public:
 abstract property bool IsInvalid { bool get(); };

public abstract bool IsInvalid { get; }

member this.IsInvalid : bool

Public MustOverride ReadOnly Property IsInvalid As Boolean

Özellik Değeri

Boolean

true tanıtıcı değeri geçersizse; aksi takdirde , false.

Örnekler

Aşağıdaki örnek, bir dosyanın başarıyla açılıp açılmadığını denetler. Bu kod örneği, sınıfı için SafeHandle sağlanan daha büyük bir örneğin parçasıdır.

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

Açıklamalar

Ortak dil çalışma zamanının IsInvalid kritik sonlandırma gerekip gerekmediğini belirleyebilmesi için türetilmiş sınıfların özelliğini uygulaması gerekir. Türetilmiş sınıflar, destekledikleri genel tanıtıcı türüne uygun bir uygulama sağlamalıdır (0 veya -1 geçersizdir). Bu sınıflar daha sonra belirli güvenli tanıtıcı türleri için daha fazla türetilebilir.

Nesnenin IsClosed temel tanıtıcıyı SafeHandle kullanmayı bitirip bitirmediğini bildiren özelliğinden IsInvalid farklı olarak, özellik verilen tanıtıcı değerinin her zaman geçersiz kabul edilip edilmediğini hesaplar. Bu nedenle, IsInvalid özelliği her zaman herhangi bir tanıtıcı değeri için aynı değeri döndürür.