FileSystem.WriteAllText Método

Definição

Namespace:

Microsoft.VisualBasic.FileIO

Assembly:

Microsoft.VisualBasic.Core.dll

Grava um texto em um arquivo.

Sobrecargas

WriteAllText(String, String, Boolean)	Grava um texto em um arquivo.
WriteAllText(String, String, Boolean, Encoding)	Grava um texto em um arquivo.

WriteAllText(String, String, Boolean)

Origem:

FileSystem.vb

Grava um texto em um arquivo.

public:
 static void WriteAllText(System::String ^ file, System::String ^ text, bool append);

public static void WriteAllText (string file, string text, bool append);

static member WriteAllText : string * string * bool -> unit

Public Shared Sub WriteAllText (file As String, text As String, append As Boolean)

Parâmetros

file

String

Arquivos que serão gravados.

text

String

O texto a ser gravado no arquivo.

append

Boolean

True para acrescentar ao conteúdo do arquivo; False para substituir o conteúdo do arquivo.

Exceções

ArgumentException

O caminho não é válido por um dos seguintes motivos: é uma cadeia de comprimento zero, contém apenas espaços em branco, contém caracteres inválidos ou é um caminho de dispositivo (começa com \\.\); ele termina com uma barra à direita.

ArgumentNullException

file é Nothing.

FileNotFoundException

O arquivo não existe.

IOException

O arquivo está sendo usado por outro processo, ou ocorre um erro de E/S.

PathTooLongException

O caminho excede o tamanho máximo definido pelo sistema.

NotSupportedException

Um nome de arquivo ou de diretório no caminho contém dois-pontos (:) ou está em um formato inválido.

OutOfMemoryException

Não há memória suficiente para gravar a cadeia de caracteres no buffer.

SecurityException

O usuário não tem as permissões necessárias para exibir o caminho.

Exemplos

Este exemplo grava a linha "This is new text to be added." no arquivo Test.txt, substituindo qualquer texto existente no arquivo.

My.Computer.FileSystem.WriteAllText("C:\TestFolder1\test.txt",
"This is new text to be added.", False)

Este exemplo grava os nomes dos arquivos na pasta FileList.txtem Documents and Settings , inserindo um retorno de carro entre cada um para melhor legibilidade.

For Each foundFile In
        My.Computer.FileSystem.GetFiles("C:\Documents and Settings")
    foundFile = foundFile & vbCrLf
    My.Computer.FileSystem.WriteAllText(
        "C:\Documents and Settings\FileList.txt", foundFile, True)
Next

Comentários

A codificação UTF-8 é usada para gravar no arquivo. Para especificar uma codificação diferente, use uma sobrecarga diferente do WriteAllText método .

Se o arquivo especificado não existir, ele será criado.

Se a codificação especificada não corresponder à codificação existente do arquivo, a codificação especificada será ignorada.

Observação

O WriteAllText método abre um arquivo, grava nele e o fecha. O código que usa o WriteAllText método é mais simples do que o código que usa um StreamWriter objeto . No entanto, se você estiver adicionando cadeias de caracteres a um arquivo usando um loop, um StreamWriter objeto poderá fornecer melhor desempenho porque você só precisa abrir e fechar o arquivo uma vez. Para obter mais informações, consulte o método OpenTextFileWriter.

A tabela a seguir lista exemplos de tarefas que envolvem o My.Computer.FileSystem.WriteAllText método .

Para	Consulte
Gravar texto em um arquivo	Como gravar texto em arquivos no Visual Basic
Anexar texto em um arquivo	Como anexar a arquivos de texto no Visual Basic

Confira também

• Encoding
• WriteAllText

WriteAllText(String, String, Boolean, Encoding)

Origem:

FileSystem.vb

Grava um texto em um arquivo.

public:
 static void WriteAllText(System::String ^ file, System::String ^ text, bool append, System::Text::Encoding ^ encoding);

public static void WriteAllText (string file, string text, bool append, System.Text.Encoding encoding);

static member WriteAllText : string * string * bool * System.Text.Encoding -> unit

Public Shared Sub WriteAllText (file As String, text As String, append As Boolean, encoding As Encoding)

Parâmetros

file

String

Arquivos que serão gravados.

text

String

O texto a ser gravado no arquivo.

append

Boolean

True para acrescentar ao conteúdo do arquivo; False para substituir o conteúdo do arquivo.

encoding

Encoding

A codificação a ser utilizada ao gravar um arquivo.

Exceções

ArgumentException

O caminho não é válido por um dos seguintes motivos: é uma cadeia de comprimento zero, contém apenas espaços em branco, contém caracteres inválidos ou é um caminho de dispositivo (começa com \\.\); ele termina com uma barra à direita.

ArgumentNullException

file é Nothing.

FileNotFoundException

O arquivo não existe.

IOException

O arquivo está sendo usado por outro processo, ou ocorre um erro de E/S.

PathTooLongException

O caminho excede o tamanho máximo definido pelo sistema.

NotSupportedException

Um nome de arquivo ou de diretório no caminho contém dois-pontos (:) ou está em um formato inválido.

OutOfMemoryException

Não há memória suficiente para gravar a cadeia de caracteres no buffer.

SecurityException

O usuário não tem as permissões necessárias para exibir o caminho.

Exemplos

Este exemplo grava a linha "This is new text to be added." no arquivo Test.txt, substituindo qualquer texto existente no arquivo.

My.Computer.FileSystem.WriteAllText("C:\TestFolder1\test.txt",
"This is new text to be added.", False)

Este exemplo grava os nomes dos arquivos na pasta FileList.txtem Documents and Settings , inserindo um retorno de carro entre cada um para melhor legibilidade.

For Each foundFile In
        My.Computer.FileSystem.GetFiles("C:\Documents and Settings")
    foundFile = foundFile & vbCrLf
    My.Computer.FileSystem.WriteAllText(
        "C:\Documents and Settings\FileList.txt", foundFile, True)
Next

Comentários

Se o arquivo especificado não existir, ele será criado.

Se a codificação especificada não corresponder à codificação existente do arquivo, a codificação especificada será ignorada.

Observação

O WriteAllText método abre um arquivo, grava nele e o fecha. O código que usa o WriteAllText método é mais simples do que o código que usa um StreamWriter objeto . No entanto, se você estiver adicionando cadeias de caracteres a um arquivo usando um loop, um StreamWriter objeto poderá fornecer melhor desempenho porque você só precisa abrir e fechar o arquivo uma vez. Para obter mais informações, consulte o método OpenTextFileWriter.

A tabela a seguir lista exemplos de tarefas que envolvem o My.Computer.FileSystem.WriteAllText método .

Para	Consulte
Gravar texto em um arquivo	Como gravar texto em arquivos no Visual Basic
Anexar texto em um arquivo	Como anexar a arquivos de texto no Visual Basic

Confira também

• Encoding