Marshal.FinalReleaseComObject(Object) Metode

Definisi

Ruang nama:

System.Runtime.InteropServices

Rakitan:

netstandard.dll, System.Runtime.InteropServices.dll

Sumber:

Marshal.NoCom.cs

Merilis semua referensi ke Runtime Callable Wrapper (RCW) dengan mengatur jumlah referensinya ke 0.

public:
 static int FinalReleaseComObject(System::Object ^ o);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static int FinalReleaseComObject(object o);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
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

SupportedOSPlatformAttribute

Pengecualian

ArgumentException

o bukan objek COM yang valid.

ArgumentNullException

o adalah null.

Keterangan

Metode ini FinalReleaseComObject 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 dibebaskan, meskipun ini tergantung pada implementasi objek COM dan berada di luar kontrol runtime. Namun, RCW masih bisa ada, menunggu untuk dikumpulkan sampah.

Objek COM tidak dapat digunakan setelah dipisahkan dari RCW yang mendasarnya. Jika Anda mencoba memanggil metode pada RCW setelah jumlah referensinya menjadi 0, akan InvalidComObjectException dilemparkan.

Lihat juga

• ReleaseComObject(Object)
• NullReferenceException