Partilhar via


Como: Gravar texto em arquivos no Visual Basic

O WriteAllText método 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 WriteAllText método para gravar texto em um arquivo, especificando o arquivo e o texto a ser escrito. 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

  • Percorra a coleção de cadeias de caracteres. Use o WriteAllText método para gravar texto em um arquivo, especificando o arquivo de destino e a cadeia de caracteres a serem adicionados e definindo append como True.

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

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 caracteres de comprimento zero, contém apenas espaço 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á em uso 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 diretório no caminho contém dois pontos (:) ou está em um formato inválido (NotSupportedException).

  • O usuário não tem as permissões necessárias para visualizar o caminho (SecurityException).

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

Se você estiver executando em um contexto de confiança parcial, o código pode lançar uma exceção devido a privilégios insuficientes. Para obter mais informações, consulte Noções básicas de segurança de acesso ao código.

Consulte também