Método My.Computer.FileSystem.OpenTextFileWriter

Artigo
08/25/2010

' Usage
Dim value As System.IO.StreamWriter = My.Computer.FileSystem.OpenTextFileWriter(file ,append)
Dim value As System.IO.StreamWriter = My.Computer.FileSystem.OpenTextFileWriter(file ,append ,encoding)
' Declaration
Public Function OpenTextFileWriter( _
   ByVal file As String, _
   ByVal append As Boolean _
) As System.IO.StreamWriter
' -or-
Public Function OpenTextFileWriter( _
   ByVal file As String, _
   ByVal append As Boolean, _
   ByVal encoding As System.Text.Encoding _
) As System.IO.StreamWriter

Parâmetros

file
String.Arquivo a ser gravado.Obrigatório.
append
Boolean.Especifica se deve acrescentar ou substituir informações contidas no arquivo.Obrigatório.
encoding
Encoding.Codificação a ser usado em gravar no arquivo.O padrão é UTF8.

Valor de retorno

StreamWriter

Exceções

A seguinte condição pode fazer com que uma exceção seja lançada:

O nome do arquivo termina com uma barra (ArgumentException).

Comentários

O método OpenTextFileWriter abre e inicializa um fluxo de um arquivo e, em seguida, retorna o objeto StreamWriter para esse fluxo.Você pode gravar no fluxo quantas vezes forem necessárias e fechá-lo quando você terminar.

Observação:
Você deve Ligue o Close método na StreamWriter objeto para certificar-se de que todos os dados sejam gravados corretamente o fluxo subjacente.

Se o parâmetro append for True,o método anexa o texto ao arquivo; caso contrário, o texto existente no arquivo será sobrescrito.

Se você estiver escrevendo apenas algumas sequências de caracteres em um arquivo, pode ser mais simples usar o método WriteAllText.Para obter mais informações, consulte Método My.Computer.FileSystem.WriteAllText.

Tarefas

A tabela seguinte lista um exemplo de tarefa envolvendo o método My.Computer.FileSystem.OpenTextFileWriter.

Para	Consulte
Escreve texto em um arquivo, usando um StreamWriter	Como: Gravar texto em arquivos com um StreamWriter no Visual Basic

Exemplo

Este exemplo abre um StreamWriter com o método My.Computer.FileSystem.OpenTextFileWriter e usa-o para escrever uma sequência de caracteres em um arquivo de texto usando o método WriteLine da classe StreamWriter.

Dim file As System.IO.StreamWriter
file = My.Computer.FileSystem.OpenTextFileWriter("c:\test.txt", True)
file.WriteLine("Here is the first string.")
file.Close()

Requisitos

Namespace:Microsoft.VisualBasic.MyServices

Classe:FileSystemProxy (fornece acesso a FileSystem)

Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Disponibilidade por Tipo de Projeto

Tipo de Projeto	Disponível
Aplicativo do Windows	Sim
Biblioteca de Classe	Sim
Aplicativo de Console	Sim
Biblioteca de Controle do Windows	Sim
Biblioteca de Controle da Web	Sim
Serviço do Windows	Sim
Site	Sim