Marshal.FinalReleaseComObject(Object) Metode

Referensi

Definisi

Ruang nama:: System.Runtime.InteropServices

Rakitan:: System.Runtime.InteropServices.dll

Rakitan:: mscorlib.dll

Rakitan:: netstandard.dll

Sumber:: Marshal.NoCom.cs

Sumber:: Marshal.NoCom.cs

Sumber:: Marshal.NoCom.cs

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 -> int

static member FinalReleaseComObject : obj -> int

Public Shared Function FinalReleaseComObject (o As Object) As Integer

Parameter

o: Object

RCW yang akan dirilis.

Mengembalikan

Int32

Nilai baru jumlah referensi RCW yang terkait dengan o parameter , yaitu 0 (nol) jika rilis berhasil.

Atribut: SecurityCriticalAttribute SupportedOSPlatformAttribute

Pengecualian

ArgumentException

o bukan objek COM yang valid.

ArgumentNullException

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.

Berlaku untuk

Bagikan melalui