IClosable.Close 方法

定義

命名空間:

Windows.Foundation

釋放由 Windows 執行階段 物件公開的系統資源。

。網 此介面會顯示為 System.IDisposable。

C++/CX 此介面會顯示為 Platform：：IDisposable。

public:
 void Close();

void Close();

public void Close();

function close()

Public Sub Close ()

備註

下列實作/呼叫端附注主要與 WRL 相關。

實作者的注意事項

實作這個方法以釋放正在使用中的獨佔系統資源，例如檔案控制代碼、資料流程和網路通訊端。 方法也應該釋放使用中的其他資源，包括物件參考和記憶體，以準備它們以供重複使用。

這個方法必須呼叫它所保留實作 IClosable之任何物件的 Close 方法。

Close 方法應該儘快釋放系統資源，而不會封鎖非同步作業才能完成。 為了確保所有資源都完全釋放，呼叫端必須先等候所有未完成的非同步作業完成，再呼叫 Close。

在 Close 傳回之後，物件仍在記憶體中，但不需要系統資源;因此，大部分的成員都無法使用。 相依于已發行系統資源的成員可以傳回 RO_E_CLOSED ，以指出物件已關閉，而且無法完成要求的作業。

來電者附注

如果您多次呼叫 Close，則沒有任何作用;方法會傳回 S_OK。

關閉方法無法在實作IClosable的類別實例上 Windows 執行階段透過 C++/CX 呼叫，但會在目前範圍結尾自動呼叫。 執行時間類別的 C++/CX 程式碼應該呼叫解構函式，或將最後一個參考設定為 null。

在 C# 中，這個方法會公開為 Dispose。 您可以直接呼叫 Dispose 或使用 using 語句。