FileSystemProxy.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 texto em um arquivo.
Sobrecargas
| Nome | Description |
|---|---|
| WriteAllText(String, String, Boolean) |
Grava texto em um arquivo. |
| WriteAllText(String, String, Boolean, Encoding) |
Grava texto em um arquivo. |
WriteAllText(String, String, Boolean)
Grava 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 -> unitPublic Sub WriteAllText (file As String, text As String, append As Boolean)Parâmetros
- file
- String
Arquivo a ser gravado.
- text
- String
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 caracteres de comprimento zero; ele contém apenas espaço em branco; ele contém caracteres inválidos; ou é um caminho do dispositivo (começa com \\.\); termina com uma barra à direita.
file é Nothing.
O arquivo não existe.
O arquivo está em uso por outro processo ou ocorre um erro de E/S.
O caminho excede o comprimento máximo definido pelo sistema.
Um nome de arquivo ou 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 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 Documents and Settings pasta, FileList.txtinserindo um retorno de carro entre cada um para obter 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 OpenTextFileWriter método.
A tabela a seguir lista exemplos de tarefas que envolvem o My.Computer.FileSystem.WriteAllText método.
| Para | Veja |
|---|---|
| Gravar texto em um arquivo | Como gravar texto em arquivos |
| Acrescentar texto a um arquivo | Como acrescentar a arquivos de texto |
Confira também
- Encoding
- WriteAllText(String, String, Boolean)
- Objetos (Visual Basic)
- Writing to Files in Visual Basic
Aplica-se a
WriteAllText(String, String, Boolean, Encoding)
Grava 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 -> unitPublic Sub WriteAllText (file As String, text As String, append As Boolean, encoding As Encoding)Parâmetros
- file
- String
Arquivo a ser gravado.
- text
- String
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
Qual codificação usar ao gravar no arquivo. O padrão é UTF-8.
Exceções
O caminho não é válido por um dos seguintes motivos: é uma cadeia de caracteres de comprimento zero; ele contém apenas espaço em branco; ele contém caracteres inválidos; ou é um caminho do dispositivo (começa com \\.\); termina com uma barra à direita.
file é Nothing.
O arquivo não existe.
O arquivo está em uso por outro processo ou ocorre um erro de E/S.
O caminho excede o comprimento máximo definido pelo sistema.
Um nome de arquivo ou 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 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 Documents and Settings pasta, FileList.txtinserindo um retorno de carro entre cada um para obter 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 OpenTextFileWriter método.
A tabela a seguir lista exemplos de tarefas que envolvem o My.Computer.FileSystem.WriteAllText método.
| Para | Veja |
|---|---|
| Gravar texto em um arquivo | Como gravar texto em arquivos |
| Acrescentar texto a um arquivo | Como acrescentar a arquivos de texto |