FileSystem.OpenTextFileWriter Método

Definição

Espaço de Nomes:: Microsoft.VisualBasic.FileIO

Assemblagem:: Microsoft.VisualBasic.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Abre um StreamWriter objeto para escrever no ficheiro especificado.

Sobrecargas

Name	Description
OpenTextFileWriter(String, Boolean)	Abre um StreamWriter objeto para escrever no ficheiro especificado.
OpenTextFileWriter(String, Boolean, Encoding)	Abre um StreamWriter para escrever no ficheiro especificado.

OpenTextFileWriter(String, Boolean)

Abre um StreamWriter objeto para escrever no ficheiro 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

Ficheiro para ser escrito.

append: Boolean

True para acrescentar ao conteúdo do ficheiro; False para sobrescrever o conteúdo do ficheiro. A predefinição é False.

Devoluções

StreamWriter

StreamWriter objeto para escrever no ficheiro especificado.

Exceções

ArgumentNullException

file é Nothing ou uma corda vazia.

ArgumentException

O nome do ficheiro termina com uma barra final.

Exemplos

Este exemplo abre um StreamWriter com o My.Computer.FileSystem.OpenTextFileWriter método e usa-o para escrever uma string num ficheiro 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()

Observações

O OpenTextFileWriter método abre e inicializa um fluxo para um ficheiro e depois devolve o StreamWriter objeto desse fluxo. Podes escrever no Steam quantas vezes for necessário e depois fechá-lo quando terminares.

Note

Deve chamar o Close método no StreamWriter objeto para garantir que todos os dados estão corretamente escritos no fluxo subjacente.

Se estiver a escrever apenas algumas strings num ficheiro, pode ser mais simples usar o WriteAllText método.

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

Para	Veja
Escrever texto num ficheiro com um `StreamWriter`	Como: Escrever Texto em Ficheiros com um StreamWriter em Visual Basic

Ver também

Aplica-se a

OpenTextFileWriter(String, Boolean, Encoding)

Abre um StreamWriter para escrever no ficheiro 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