Método My.Computer.FileSystem.WriteAllText

Artigo
08/25/2010

Grava um arquivo de texto.

' Usage
My.Computer.FileSystem.WriteAllText(file ,text ,append)
My.Computer.FileSystem.WriteAllText(file ,text ,append ,encoding)
' Declaration
Public Sub WriteAllText( _
   ByVal file As String, _
   ByVal text As String, _
   ByVal append As Boolean _
)
' -or-
Public Sub WriteAllText( _
   ByVal file As String, _
   ByVal text As String, _
   ByVal append As Boolean, _
   ByVal encoding As System.Text.Encoding _
)

Parâmetros

file
String.Arquivo a ser gravado.Obrigatório.
text
String.Texto a ser escrito para o arquivo.Obrigatório.
append
Boolean.Se acrescentar texto ou substituir texto existente.O padrão é False.Obrigatório.
encoding
Encoding.Que codificação a ser usado ao gravar no arquivo.Obrigatório.O padrão é UTF-8.

Exceções

As seguintes condições podem causar uma exceção:

O caminho inválido por causa de um dos seguintes motivos: Ele é uma cadeia de comprimento zero; ele contém somente espaços em branco; ele contém caracteres inválidos, termina com uma barra / à direita, ou é um caminho de dispositivo (começa com \\.\) (ArgumentException).
O caminho não é válido porque ele é Nothing (ArgumentNullException).
file aponta para um caminho que não existe (FileNotFoundException ou DirectoryNotFoundException).
O arquivo está sendo usado por outro processo ou ocorreu um erro de E/s (IOException).
O caminho excede o comprimento máximo definido pelo sistema (PathTooLongException).
Um nome de arquivo ou de diretório no caminho contém dois-pontos (:) ou está em um formato inválido (NotSupportedException).
O usuário não possui permissões necessárias para exibir o caminho (SecurityException).

Se você estiver executando em um contexto parcialmente confiável, o código pode lançar uma exceção devido à insuficiência de permissões.Para obter mais informações, consulte Noções Básicas sobre Segurança de Accesso a Código.

Comentários

Quando nenhuma codificação é especificada, UTF-8 é usado.A marca de ordem de byte (BOM) para a codificação é gravada no arquivo, a menos que você especifique Encoding.Default, que usa a página de código ANSI corrente do sistema. Se a codificação especificada não corresponder a codificação existente do arquivo, a codificação especificada será ignorada.

Se inválido for válido, o caminho especificado, nome de arquivo, exceto um DirectoryNotFoundException exceção é lançada. Se o caminho é válido, mas o arquivo não existir, o arquivo é criado.

Se o parâmetro append for True,o método anexa o texto ao arquivo; caso contrário, o texto existente no arquivo será sobrescrito.

Observação:
O WriteAllText método abre um arquivo, grava-lo e fechá-lo. Código que usa o WriteAllText método é mais simples do que o código que usa um StreamWriter objeto. No entanto, se são adicionar seqüências de caracteres em um arquivo usando um loop, um StreamWriter objeto pode fornecer um desempenho melhor porque você apenas em aberto e fechar o arquivo de um time. Para obter mais informações, consulte Método My.Computer.FileSystem.OpenTextFileWriter.

O WriteAllText método abre um arquivo, grava-lo e fechá-lo. Código que usa o WriteAllText método é mais simples do que o código que usa um StreamWriter objeto. No entanto, se são adicionar seqüências de caracteres em um arquivo usando um loop, um StreamWriter objeto pode fornecer um desempenho melhor porque você apenas em aberto e fechar o arquivo de um time. Para obter mais informações, consulte Método My.Computer.FileSystem.OpenTextFileWriter.

Tarefas

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
Acrescentar texto a um arquivo	Como: Acrescentar a arquivos de texto no Visual Basic

Exemplo

Este exemplo grava a linha "This is new text to be added." o 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 no Documents and Settings pasta para FileList.txt, inserindo um carro retornar entre cada para melhor legibilidade.

For Each foundFile As String 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

Requisitos

Namespace:Microsoft.VisualBasic.MyServices

Classe:FileSystemProxy (fornece acesso a FileSystem)

Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Disponibilidade por Tipo de Projeto

Tipo de Projeto	Disponível
Aplicativo do Windows	Sim
Biblioteca de Classe	Sim
Aplicativo de Console	Sim
Biblioteca de Controle do Windows	Sim
Biblioteca de Controle da Web	Sim
Serviço do Windows	Sim
Site	Sim