Marshal.FinalReleaseComObject(Object) Metode
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.
Merilis semua referensi ke Runtime Callable Wrapper (RCW) dengan mengatur jumlah referensinya ke 0.
public:
static int FinalReleaseComObject(System::Object ^ o);[System.Security.SecurityCritical]
public static int FinalReleaseComObject (object o);[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static int FinalReleaseComObject (object o);public static int FinalReleaseComObject (object o);[<System.Security.SecurityCritical>]
static member FinalReleaseComObject : obj -> int[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member FinalReleaseComObject : obj -> intstatic member FinalReleaseComObject : obj -> intPublic Shared Function FinalReleaseComObject (o As Object) As IntegerParameter
- o
- Object
RCW yang akan dirilis.
Mengembalikan
Nilai baru jumlah referensi RCW yang terkait dengan o parameter , yaitu 0 (nol) jika rilis berhasil.
- Atribut
Pengecualian
o bukan objek COM yang valid.
oadalah null.
Keterangan
Metode FinalReleaseComObject ini merilis referensi terkelola ke objek COM. Memanggil metode ini setara dengan memanggil ReleaseComObject metode dalam perulangan hingga mengembalikan 0 (nol).
Ketika jumlah referensi pada objek COM menjadi 0, objek COM biasanya dikosongkan, meskipun ini tergantung pada implementasi objek COM dan berada di luar kendali runtime. Namun, RCW masih bisa ada, menunggu untuk dikumpulkan sampah.
Objek COM tidak dapat digunakan setelah dipisahkan dari RCW yang mendasar. Jika Anda mencoba memanggil metode pada RCW setelah jumlah referensinya menjadi 0, InvalidComObjectException akan dilemparkan.
