SafeHandleZeroOrMinusOneIsInvalid Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menyediakan kelas dasar untuk implementasi handel aman Win32 di mana nilai 0 atau -1 menunjukkan handel yang tidak valid.
public ref class SafeHandleZeroOrMinusOneIsInvalid abstract : System::Runtime::InteropServices::SafeHandle
public abstract class SafeHandleZeroOrMinusOneIsInvalid : System.Runtime.InteropServices.SafeHandle
[System.Security.SecurityCritical]
public abstract class SafeHandleZeroOrMinusOneIsInvalid : System.Runtime.InteropServices.SafeHandle
type SafeHandleZeroOrMinusOneIsInvalid = class
inherit SafeHandle
[<System.Security.SecurityCritical>]
type SafeHandleZeroOrMinusOneIsInvalid = class
inherit SafeHandle
Public MustInherit Class SafeHandleZeroOrMinusOneIsInvalid
Inherits SafeHandle
- Warisan
- Turunan
- Atribut
Keterangan
Kelas ini berasal dari System.Runtime.InteropServices.SafeHandle kelas . Ini menjelaskan format handel yang tidak valid. Misalnya, beberapa handel menggunakan -1 sebagai nilai handel yang tidak valid, sementara yang lain menggunakan 0. Derivasi lebih lanjut dari kelas ini (misalnya, handel file atau registri) dapat mengkhianati hal ini lebih lanjut. SafeFileHandle Lihat kelas untuk contoh kelas yang berasal dari SafeHandleZeroOrMinusOneIsInvalid.
Important
Jenis ini mengimplementasikan antarmuka IDisposable. Setelah selesai menggunakan jenis tersebut, Anda harus menyingkirkannya baik secara langsung maupun tidak langsung. Untuk meniadakan tipe secara langsung, panggil metode Dispose dalam blok try/catch. Untuk membuangnya secara tidak langsung, gunakan konstruksi bahasa seperti using (dalam C#) atau Using (di Visual Basic). Untuk informasi selengkapnya, lihat bagian "Menggunakan Objek yang Menerapkan IDisposable" dalam IDisposable topik antarmuka.
SafeHandleZeroOrMinusOneIsInvalid Gunakan kelas setiap kali Anda perlu membungkus sumber daya yang tidak dikelola dengan aman yang tidak memiliki pembungkus terkelola yang ada.
Konstruktor
| Nama | Deskripsi |
|---|---|
| SafeHandleZeroOrMinusOneIsInvalid(Boolean) |
Menginisialisasi instans SafeHandleZeroOrMinusOneIsInvalid baru kelas, menentukan apakah handel akan dirilis dengan andal. |
Bidang
| Nama | Deskripsi |
|---|---|
| handle |
Menentukan handel yang akan dibungkus. (Diperoleh dari SafeHandle) |
Properti
| Nama | Deskripsi |
|---|---|
| IsClosed |
Mendapatkan nilai yang menunjukkan apakah handel ditutup. (Diperoleh dari SafeHandle) |
| IsInvalid |
Mendapatkan nilai yang menunjukkan apakah handel tidak valid. |
Metode
| Nama | Deskripsi |
|---|---|
| Close() |
Menandai handel untuk melepaskan dan membebaskan sumber daya. (Diperoleh dari SafeHandle) |
| DangerousAddRef(Boolean) |
Secara manual menaikkan penghitung referensi pada SafeHandle instans. (Diperoleh dari SafeHandle) |
| DangerousGetHandle() |
Mengembalikan nilai handle bidang. (Diperoleh dari SafeHandle) |
| DangerousRelease() |
Menurunkan penghitung referensi secara manual pada SafeHandle instans. (Diperoleh dari SafeHandle) |
| Dispose() |
Merilis semua sumber daya yang SafeHandle digunakan oleh kelas . (Diperoleh dari SafeHandle) |
| Dispose(Boolean) |
Merilis sumber daya yang tidak dikelola yang SafeHandle digunakan oleh kelas yang menentukan apakah akan melakukan operasi pembuangan normal. (Diperoleh dari SafeHandle) |
| Equals(Object) |
Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object) |
| GetHashCode() |
Berfungsi sebagai fungsi hash default. (Diperoleh dari Object) |
| GetType() |
Mendapatkan Type instans saat ini. (Diperoleh dari Object) |
| MemberwiseClone() |
Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object) |
| ReleaseHandle() |
Ketika ditimpa dalam kelas turunan, menjalankan kode yang diperlukan untuk membebaskan handel. (Diperoleh dari SafeHandle) |
| SetHandle(IntPtr) |
Mengatur handel ke handel yang sudah ada sebelumnya yang ditentukan. (Diperoleh dari SafeHandle) |
| SetHandleAsInvalid() |
Menandai handel sebagai tidak lagi digunakan. (Diperoleh dari SafeHandle) |
| ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |