ZipArchive.Dispose 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
釋放由 ZipArchive 物件使用的所有資源。
多載
Dispose() |
將 ZipArchive 類別的目前執行個體所使用的資源釋出。 |
Dispose(Boolean) |
由 Dispose() 和 Finalize() 方法呼叫以釋放 ZipArchive 類別之目前執行個體所使用的 Unmanaged 資源,並選擇性完成封存的寫入以及釋放 Managed 資源。 |
Dispose()
將 ZipArchive 類別的目前執行個體所使用的資源釋出。
public:
virtual void Dispose();
public void Dispose ();
abstract member Dispose : unit -> unit
override this.Dispose : unit -> unit
Public Sub Dispose ()
實作
備註
這個方法會完成寫入封存,並釋放 物件所使用的 ZipArchive 所有資源。 除非您使用建構函式多載來建構物件, ZipArchive(Stream, ZipArchiveMode, Boolean) 並將其 leaveOpen
參數設定為 true
,否則所有基礎資料流程都會關閉,且無法再供後續寫入作業使用。
當您完成使用此 實例 ZipArchive 時,請呼叫 Dispose() 以釋放這個實例所使用的所有資源。 您應該排除此 ZipArchive 實例的進一步參考,讓垃圾收集行程可以回收實例的記憶體,而不是讓實例保持運作以進行最終處理。
Dispose()Dispose(Boolean)會呼叫 方法,其中包含釋放 Managed 和 Unmanaged 資源的程式碼。 如需詳細資訊,請參閱 實作 Dispose 方法。
適用於
Dispose(Boolean)
由 Dispose() 和 Finalize() 方法呼叫以釋放 ZipArchive 類別之目前執行個體所使用的 Unmanaged 資源,並選擇性完成封存的寫入以及釋放 Managed 資源。
protected:
virtual void Dispose(bool disposing);
protected virtual void Dispose (bool disposing);
abstract member Dispose : bool -> unit
override this.Dispose : bool -> unit
Protected Overridable Sub Dispose (disposing As Boolean)
參數
- disposing
- Boolean
true
表示完成寫入封存並釋放 Managed 和 Unmanaged 資源,false
表示只釋放 Unmanaged 資源。
備註
如果 disposing
設定為 true
,則所有基礎資料流程都會關閉,且無法再供後續寫入作業使用,除非您使用 ZipArchive(Stream, ZipArchiveMode, Boolean) 建構函式多載建構物件,並將其參數設定 leaveOpen
為 true
。
這個方法只能由公用 Dispose() 和 Finalize() 方法呼叫;請勿直接呼叫這個方法。
當您實作處置模式時,應該使用 方法的 Dispose(Boolean) 布林參數,如下所示:
Dispose()目前 物件的 方法應該使用設為
true
的布林參數呼叫 Dispose(Boolean) ,以釋放 Managed 和 Unmanaged 資源。目前 Finalize() 物件的 方法應該呼叫 Dispose(Boolean) ,並將布林參數設定為
false
,只釋放 Unmanaged 資源。
如需詳細資訊,請參閱 實作 Dispose 方法。