IClosable.Close 方法

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

编辑

释放由 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。

关闭方法不能通过Windows 运行时类实现 IClosable 的类实例上的 C++/CX 调用，但在当前范围的末尾自动调用。运行时类的 C++/CX 代码应调用析构函数或将最后一个引用设置为 null。

在 C# 中，此方法公开为 Dispose。可以直接调用 Dispose 或使用 using 语句。