TextWriter.Dispose 方法

定义

释放 TextWriter 对象使用的所有资源。Releases all resources used by the TextWriter object.

重载

Dispose()

释放 TextWriter 对象使用的所有资源。Releases all resources used by the TextWriter object.

Dispose(Boolean)

释放 TextWriter 使用的非托管资源并选择性地释放托管资源。Releases the unmanaged resources used by the TextWriter and optionally releases the managed resources.

Dispose()

释放 TextWriter 对象使用的所有资源。Releases all resources used by the TextWriter object.

public:
 virtual void Dispose();
public void Dispose ();
abstract member Dispose : unit -> unit
override this.Dispose : unit -> unit
Public Sub Dispose ()

实现

注解

在完成使用 Dispose 后,应调用 TextWriterCall Dispose when you are finished using the TextWriter. Dispose 方法使 TextWriter 处于不可用状态。The Dispose method leaves the TextWriter in an unusable state. 调用 Dispose后,必须释放对 TextWriter 的所有引用,以便垃圾回收器可以回收 TextWriter 占用的内存。After calling Dispose, you must release all references to the TextWriter so the garbage collector can reclaim the memory that the TextWriter was occupying.

有关详细信息,请参阅清理非托管资源实现 Dispose 方法For more information, see Cleaning Up Unmanaged Resources and Implementing a Dispose Method.

注意在释放对 TextWriter的最后一个引用之前,请始终调用 DisposeNote Always call Dispose before you release your last reference to the TextWriter. 否则,在垃圾回收器调用 TextWriter 对象的 Finalize 方法之前,该对象正在使用的资源不会被释放。Otherwise, the resources it is using will not be freed until the garbage collector calls the TextWriter object's Finalize method.

Dispose(Boolean)

释放 TextWriter 使用的非托管资源并选择性地释放托管资源。Releases the unmanaged resources used by the TextWriter and optionally releases the managed resources.

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,则托管及非托管资源都释放;如果为 false,则仅释放非托管资源。true to release both managed and unmanaged resources; false to release only unmanaged resources.

注解

此方法由 DisposeFinalize调用。This method is called by Dispose and Finalize. 默认情况下,此方法将 disposing 参数指定为 trueBy default, this method specifies the disposing parameter as true. Finalizedisposing 参数指定为 falseFinalize specifies the disposing parameter as false.

disposing 参数为 true 时,此方法释放该 TextWriter 引用的、由任何托管对象持有的全部资源。When the disposing parameter is true, this method releases all resources held by any managed objects that this TextWriter references. 此方法将调用每个被引用对象的 Dispose 方法。This method invokes the Dispose method of each referenced object.

继承者说明

Dispose(Boolean) 可以由其他对象多次调用。 Dispose(Boolean) can be called multiple times by other objects. 重写此方法时,请注意不要引用先前在中调用 Dispose的对象。When overriding this method, be careful not to reference objects that have been previously disposed of in an earlier call to Dispose. 有关如何实现此方法的详细信息,请参阅[实现 Dispose 方法](~/docs/standard/garbage-collection/implementing-dispose.md)。For more information about how to implement this method, see [Implementing a Dispose Method](~/docs/standard/garbage-collection/implementing-dispose.md). 有关 Dispose()Finalize()的详细信息,请参阅[清理非托管资源](~/docs/standard/garbage-collection/unmanaged.md)。For more information about Dispose() and Finalize(), see [Cleaning Up Unmanaged Resources](~/docs/standard/garbage-collection/unmanaged.md).

另请参阅

适用于