SafeHandle.IsInvalid Properti

Definisi

Ruang nama:

System.Runtime.InteropServices

Rakitan:

System.Runtime.dll

Sumber:

SafeHandle.cs

Saat ditimpa di kelas turunan, mendapatkan nilai yang menunjukkan apakah nilai handel tidak valid.

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

public abstract bool IsInvalid { get; }

member this.IsInvalid : bool

Public MustOverride ReadOnly Property IsInvalid As Boolean

Nilai Properti

Boolean

true jika nilai handel tidak valid; jika tidak, false.

Contoh

Contoh berikut memeriksa apakah file berhasil dibuka. Contoh kode ini adalah bagian dari contoh yang lebih besar yang disediakan untuk SafeHandle kelas .

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

Keterangan

Kelas turunan harus mengimplementasikan IsInvalid properti sehingga runtime bahasa umum dapat menentukan apakah finalisasi penting diperlukan. Kelas turunan harus menyediakan implementasi yang sesuai dengan jenis handel umum yang didukungnya (0 atau -1 tidak valid). Kelas-kelas ini kemudian dapat diturunkan lebih lanjut untuk jenis handel aman tertentu.

IsClosed Tidak seperti properti , yang melaporkan apakah SafeHandle objek telah selesai menggunakan handel yang mendasar, IsInvalid properti menghitung apakah nilai handel yang diberikan selalu dianggap tidak valid. Oleh karena itu, IsInvalid properti selalu mengembalikan nilai yang sama untuk satu nilai handel.