TextWriter.Dispose Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Libera todos os recursos usados pelo objeto TextWriter.

Sobrecargas

Dispose()	Libera todos os recursos usados pelo objeto TextWriter.
Dispose(Boolean)	Libera os recursos não gerenciados usados pelo TextWriter e opcionalmente libera os recursos gerenciados.

Dispose()

Origem:

TextWriter.cs

Libera todos os recursos usados pelo objeto TextWriter.

C#

public void Dispose ();

Implementações

Dispose()

Comentários

Chame Dispose quando terminar de usar o TextWriter. O Dispose método deixa o TextWriter em um estado inutilizável. Depois de chamar Dispose, você deve liberar todas as referências para o TextWriter para que o coletor de lixo possa recuperar a memória que o TextWriter estava ocupando.

Para obter mais informações, consulte Limpando recursos não gerenciados e implementando um método dispose.

Nota Sempre chame Dispose antes de liberar sua última referência ao TextWriter. Caso contrário, os recursos que ele está usando não serão liberados até que o coletor de lixo chame o TextWriter método do Finalize objeto.

Dispose(Boolean)

Origem:

TextWriter.cs

Libera os recursos não gerenciados usados pelo TextWriter e opcionalmente libera os recursos gerenciados.

C#

protected virtual void Dispose (bool disposing);

Parâmetros

disposing

Boolean

true para liberar recursos gerenciados e não gerenciados; false para liberar apenas recursos não gerenciados.

Comentários

Esse método é chamado por Dispose e Finalize. Por padrão, esse método especifica o disposing parâmetro como true. Finalize especifica o disposing parâmetro como false.

Quando o disposing parâmetro é true, esse método libera todos os recursos mantidos por todos os objetos gerenciados que isso TextWriter referencia. Este método invoca o método Dispose de cada objeto referenciado.

Notas aos Herdeiros

Dispose(Boolean) pode ser chamado várias vezes por outros objetos. Ao substituir esse método, tenha cuidado para não fazer referência a objetos que foram descartados anteriormente em uma chamada anterior para Dispose. Para obter mais informações sobre como implementar esse método, consulte Implementando um método Dispose.

Para obter mais informações sobre Dispose() e Finalize(), consulte Limpando recursos não gerenciados.

Confira também

• E/S de arquivo e de fluxo
• Como ler texto de um arquivo
• Como gravar texto em um arquivo