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.

注意在释放Dispose对的TextWriter最后一个引用之前,始终调用。Note 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;若仅释放非托管资源,则为 falsetrue to release both managed and unmanaged resources; false to release only unmanaged resources.

注解

此方法由DisposeFinalize调用。This method is called by Dispose and Finalize. 默认情况下,此方法将disposing参数指定true为。By default, this method specifies the disposing parameter as true. Finalize指定参数为falsedisposingFinalize 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).

另请参阅

适用于