Compartilhar via


Como gravar texto em arquivos no Visual Basic

O método WriteAllText pode ser usado para gravar texto em arquivos. Se o arquivo especificado não existir, ele será criado.

Procedimento

Para gravar texto em um arquivo

  • Use o método WriteAllText para gravar texto em um arquivo, especificando o arquivo e o texto a ser gravado. Este exemplo grava a linha "This is new text." no arquivo chamado test.txt, anexando o texto a qualquer texto existente no arquivo.

    My.Computer.FileSystem.WriteAllText("C:\TestFolder1\test.txt",
    "This is new text to be added.", True)
    

Para gravar uma série de cadeias de caracteres em um arquivo

  • Faça um loop na coleção de cadeia de caracteres. Use o método WriteAllText para gravar texto em um arquivo, especificando o arquivo de destino e a cadeia de caracteres a ser adicionada e configurando append como True.

    Este exemplo grava os nomes dos arquivos no diretório Documents and Settings em FileList.txt, inserindo um retorno de carro entre cada um para obter 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
    

Programação robusta

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

  • 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 \\.\) (ArgumentException).

  • O caminho não é válido porque é Nothing (ArgumentNullException).

  • File aponta para um caminho que não existe (FileNotFoundException ou DirectoryNotFoundException).

  • O arquivo está sendo usado por outro processo, ou ocorre 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).

  • O disco está cheio e a chamada a WriteAllText falha (IOException).

Se você estiver executando em um contexto de confiança parcial, o código pode gerar uma exceção devido a privilégios insuficientes. Para obter mais informações, consulte Noções Básicas da Segurança de Acesso do Código.

Confira também