FileSystem.OpenTextFileWriter Método

Definição

Namespace:

Microsoft.VisualBasic.FileIO

Assembly:

Microsoft.VisualBasic.Core.dll

Abre um objeto StreamWriter no qual o arquivo especificado será gravado.

Sobrecargas

OpenTextFileWriter(String, Boolean)	Abre um objeto StreamWriter no qual o arquivo especificado será gravado.
OpenTextFileWriter(String, Boolean, Encoding)	Abre um StreamWriter para gravar no arquivo especificado.

OpenTextFileWriter(String, Boolean)

Origem:

FileSystem.vb

Abre um objeto StreamWriter no qual o arquivo especificado será gravado.

public:
 static System::IO::StreamWriter ^ OpenTextFileWriter(System::String ^ file, bool append);

public static System.IO.StreamWriter OpenTextFileWriter (string file, bool append);

static member OpenTextFileWriter : string * bool -> System.IO.StreamWriter

Public Shared Function OpenTextFileWriter (file As String, append As Boolean) As StreamWriter

Parâmetros

file

String

Arquivos que serão gravados.

append

Boolean

True para acrescentar ao conteúdo do arquivo; False para substituir o conteúdo do arquivo. O padrão é False.

Retornos

StreamWriter

Objeto StreamWriter no qual o arquivo especificado será gravado.

Exceções

ArgumentNullException

file é Nothing ou é uma cadeia de caracteres vazia.

ArgumentException

O nome do arquivo termina com uma barra.

Exemplos

Este exemplo abre um StreamWriter com o My.Computer.FileSystem.OpenTextFileWriter método e o usa para gravar uma cadeia de caracteres em um arquivo de texto com o WriteLine método da StreamWriter classe .

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

Comentários

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

Observação

Você deve chamar o Close método no StreamWriter objeto para garantir que todos os dados sejam gravados corretamente no fluxo subjacente.

Se você estiver escrevendo apenas algumas cadeias de caracteres em um arquivo, talvez seja mais simples usar o WriteAllText método .

A tabela a seguir lista um exemplo de uma tarefa que envolve o My.Computer.FileSystem.OpenTextFileWriter método .

Para	Consulte
Gravar texto em um arquivo com um StreamWriter	Como gravar texto em arquivos com um StreamWriter no Visual Basic

Confira também

• Encoding
• StreamWriter

OpenTextFileWriter(String, Boolean, Encoding)

Origem:

FileSystem.vb

Abre um StreamWriter para gravar no arquivo especificado.

public:
 static System::IO::StreamWriter ^ OpenTextFileWriter(System::String ^ file, bool append, System::Text::Encoding ^ encoding);

public static System.IO.StreamWriter OpenTextFileWriter (string file, bool append, System.Text.Encoding encoding);

static member OpenTextFileWriter : string * bool * System.Text.Encoding -> System.IO.StreamWriter

Public Shared Function OpenTextFileWriter (file As String, append As Boolean, encoding As Encoding) As StreamWriter

Parâmetros

file

String

Arquivos que serão gravados.

append

Boolean

True para acrescentar ao conteúdo do arquivo; False para substituir o conteúdo do arquivo. O padrão é False.

encoding

Encoding

Codificação a ser usada na gravação no arquivo. O padrão é ASCII.

Retornos

StreamWriter

Objeto StreamWriter no qual o arquivo especificado será gravado.

Exceções

ArgumentNullException

file é Nothing ou é uma cadeia de caracteres vazia.

ArgumentException

O nome do arquivo termina com uma barra.

Exemplos

Este exemplo abre um StreamWriter com o My.Computer.FileSystem.OpenTextFileWriter método com Unicode codificação e o usa para gravar uma cadeia de caracteres em um arquivo de texto com o WriteLine método da StreamWriter classe .

Dim file = My.Computer.FileSystem.OpenTextFileWriter(
    "c:\test.txt", True, Text.Encoding.Unicode)
file.WriteLine("Here is the first string.")
file.Close()

Comentários

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

Observação

Você deve chamar o Close método no StreamWriter objeto para garantir que todos os dados sejam gravados corretamente no fluxo subjacente.

Se você estiver escrevendo apenas algumas cadeias de caracteres em um arquivo, talvez seja mais simples usar o WriteAllText método .

A tabela a seguir lista um exemplo de uma tarefa que envolve o My.Computer.FileSystem.OpenTextFileWriter método .

Para	Consulte
Gravar texto em um arquivo com um StreamWriter	Como gravar texto em arquivos com um StreamWriter no Visual Basic

Confira também

• Encoding
• StreamWriter