FileSystem.OpenTextFileWriter Método

Definição

Namespace:: Microsoft.VisualBasic.FileIO

Assembly:: Microsoft.VisualBasic.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Abre um StreamWriter objeto para gravar no arquivo especificado.

Sobrecargas

Nome	Description
OpenTextFileWriter(String, Boolean)	Abre um StreamWriter objeto para gravar no arquivo especificado.
OpenTextFileWriter(String, Boolean, Encoding)	Abre um StreamWriter para gravar no arquivo especificado.

OpenTextFileWriter(String, Boolean)

Abre um StreamWriter objeto para gravar no arquivo especificado.

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

Arquivo a ser gravado.

append: Boolean

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

Retornos

StreamWriter

StreamWriter para gravar no arquivo especificado.

Exceções

ArgumentNullException

file é ou uma Nothing cadeia de caracteres vazia.

ArgumentException

O nome do arquivo termina com uma barra à direita.

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 gravar no vapor quantas vezes for necessário 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	Veja
Gravar texto em um arquivo com um `StreamWriter`	How to: Write Text to Files with a StreamWriter in Visual Basic

Confira também

Aplica-se a

OpenTextFileWriter(String, Boolean, Encoding)

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

Arquivo a ser gravado.

append: Boolean

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

encoding: Encoding

Codificação a ser usada por escrito no arquivo. O padrão é ASCII.

Retornos

StreamWriter

StreamWriter para gravar no arquivo especificado.

Exceções

ArgumentNullException

file é ou uma Nothing cadeia de caracteres vazia.

ArgumentException

O nome do arquivo termina com uma barra à direita.

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

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	Veja
Gravar texto em um arquivo com um `StreamWriter`	How to: Write Text to Files with a StreamWriter in Visual Basic

Confira também

Aplica-se a

Comentários

Esta página foi útil?