FileSystem.WriteAllText Método
Definição
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.
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
- Origem:
- FileSystem.vb
- 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 -> unitPublic 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
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 no Visual Basic |
| Anexar texto em um arquivo | Como anexar a arquivos de texto no Visual Basic |
Confira também
Aplica-se a
WriteAllText(String, String, Boolean, Encoding)
- Origem:
- FileSystem.vb
- Origem:
- FileSystem.vb
- 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 -> unitPublic 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
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 no Visual Basic |
| Anexar texto em um arquivo | Como anexar a arquivos de texto no Visual Basic |
