SafeHandle.IsInvalid Properti

Definisi

Ruang nama:

System.Runtime.InteropServices

Rakitan:

netstandard.dll, System.Runtime.dll

Sumber:

SafeHandle.cs

Saat ditimpa dalam 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 handle 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 menerapkan IsInvalid properti sehingga runtime bahasa umum dapat menentukan apakah finalisasi penting diperlukan. Kelas turunan harus memberikan implementasi yang sesuai dengan jenis penanganan 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.