FileSystemProxy.WriteAllText Método
Definição
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.
Escreve texto num ficheiro.
Sobrecargas
| Name | Description |
|---|---|
| WriteAllText(String, String, Boolean) |
Escreve texto num ficheiro. |
| WriteAllText(String, String, Boolean, Encoding) |
Escreve texto num ficheiro. |
WriteAllText(String, String, Boolean)
Escreve texto num ficheiro.
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
Ficheiro para ser escrito.
- text
- String
Texto para ser escrito no ficheiro.
- append
- Boolean
True para acrescentar ao conteúdo do ficheiro; False para sobrescrever o conteúdo do ficheiro. A predefinição é False.
Exceções
O caminho não é válido por uma das seguintes razões: é uma cadeia de comprimento zero; contém apenas espaço em branco; contém caracteres inválidos; ou é um caminho de dispositivo (começa por \\.\); termina com um corte de arrasto.
file é Nothing.
O ficheiro não existe.
O ficheiro é utilizado por outro processo, ou ocorre um erro de E/S.
O percurso excede o comprimento máximo definido pelo sistema.
Um nome de ficheiro ou diretório no caminho contém dois pontos (:) ou está num formato inválido.
Não há memória suficiente para escrever a string para buffer.
O utilizador não tem as permissões necessárias para visualizar o caminho.
Exemplos
Este exemplo escreve a linha "This is new text to be added." no ficheiro Test.txt, sobrescrevendo qualquer texto existente no ficheiro.
My.Computer.FileSystem.WriteAllText("C:\TestFolder1\test.txt",
"This is new text to be added.", False)
Este exemplo escreve os nomes dos ficheiros na Documents and Settings pasta em FileList.txt, 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
Observações
A codificação UTF-8 é usada para escrever no ficheiro. Para especificar uma codificação diferente, use uma sobrecarga diferente do WriteAllText método.
Se o ficheiro especificado não existir, ele é criado.
Se a codificação especificada não corresponder à codificação existente do ficheiro, a codificação especificada é ignorada.
Note
O WriteAllText método abre um ficheiro, escreve nele e depois fecha-o. O código que usa o WriteAllText método é mais simples do que o código que usa um StreamWriter objeto. No entanto, se estiveres a adicionar strings a um ficheiro usando um loop, um StreamWriter objeto pode proporcionar melhor desempenho porque só tens de abrir e fechar o ficheiro uma vez. Para obter mais informações, consulte o método OpenTextFileWriter.
A tabela seguinte lista exemplos de tarefas que envolvem o My.Computer.FileSystem.WriteAllText método.
| Para | Veja |
|---|---|
| Escrever texto num ficheiro | Como: Gravar texto em arquivos |
| Acrescentar texto a um ficheiro | Como: Anexar a Ficheiros de Texto |
Ver também
- Encoding
- WriteAllText(String, String, Boolean)
- Objects (Visual Basic)
- Escrita em ficheiros em Visual Basic
Aplica-se a
WriteAllText(String, String, Boolean, Encoding)
Escreve texto num ficheiro.
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
Ficheiro para ser escrito.
- text
- String
Texto para ser escrito no ficheiro.
- append
- Boolean
True para acrescentar ao conteúdo do ficheiro; False para sobrescrever o conteúdo do ficheiro. A predefinição é False.
- encoding
- Encoding
Que codificação usar ao escrever para ficheiro. O padrão é UTF-8.
Exceções
O caminho não é válido por uma das seguintes razões: é uma cadeia de comprimento zero; contém apenas espaço em branco; contém caracteres inválidos; ou é um caminho de dispositivo (começa por \\.\); termina com um corte de arrasto.
file é Nothing.
O ficheiro não existe.
O ficheiro é utilizado por outro processo, ou ocorre um erro de E/S.
O percurso excede o comprimento máximo definido pelo sistema.
Um nome de ficheiro ou diretório no caminho contém dois pontos (:) ou está num formato inválido.
Não há memória suficiente para escrever a string para buffer.
O utilizador não tem as permissões necessárias para visualizar o caminho.
Exemplos
Este exemplo escreve a linha "This is new text to be added." no ficheiro Test.txt, sobrescrevendo qualquer texto existente no ficheiro.
My.Computer.FileSystem.WriteAllText("C:\TestFolder1\test.txt",
"This is new text to be added.", False)
Este exemplo escreve os nomes dos ficheiros na Documents and Settings pasta em FileList.txt, 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
Observações
Se o ficheiro especificado não existir, ele é criado.
Se a codificação especificada não corresponder à codificação existente do ficheiro, a codificação especificada é ignorada.
Note
O WriteAllText método abre um ficheiro, escreve nele e depois fecha-o. O código que usa o WriteAllText método é mais simples do que o código que usa um StreamWriter objeto. No entanto, se estiveres a adicionar strings a um ficheiro usando um loop, um StreamWriter objeto pode proporcionar melhor desempenho porque só tens de abrir e fechar o ficheiro uma vez. Para obter mais informações, consulte o método OpenTextFileWriter.
A tabela seguinte lista exemplos de tarefas que envolvem o My.Computer.FileSystem.WriteAllText método.
| Para | Veja |
|---|---|
| Escrever texto num ficheiro | Como: Gravar texto em arquivos |
| Acrescentar texto a um ficheiro | Como: Anexar a Ficheiros de Texto |