Compartilhar via


FileSystemProxy.WriteAllText Método

Definição

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)

Grava um texto em um arquivo.

public:
 void WriteAllText(System::String ^ file, System::String ^ text, bool append);
public void WriteAllText (string file, string text, bool append);
member this.WriteAllText : string * string * bool -> unit
Public 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. O padrão é False.

Exceções

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.

file é Nothing.

O arquivo não existe.

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

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

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

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

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
Anexar texto em um arquivo Como: acrescentar a arquivos de texto

Confira também

Aplica-se a

WriteAllText(String, String, Boolean, Encoding)

Grava um texto em um arquivo.

public:
 void WriteAllText(System::String ^ file, System::String ^ text, bool append, System::Text::Encoding ^ encoding);
public void WriteAllText (string file, string text, bool append, System.Text.Encoding encoding);
member this.WriteAllText : string * string * bool * System.Text.Encoding -> unit
Public 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. O padrão é False.

encoding
Encoding

A codificação a ser utilizada ao gravar um arquivo. Padrão é UTF-8.

Exceções

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.

file é Nothing.

O arquivo não existe.

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

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

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

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

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
Anexar texto em um arquivo Como: acrescentar a arquivos de texto

Confira também

Aplica-se a