Como: Gravar texto em arquivos no diretório Meus Documentos no Visual Basic

Artigo
08/25/2010

O objeto My.Computer.FileSystem.SpecialDirectories permite que você acesse pastas especiais, como o diretório MyDocuments.

Procedimento

Para gravar novos arquivos de texto no diretório Meus Documentos

Use a propriedade My.Computer.FileSystem.SpecialDirectories.MyDocuments para fornecer o caminho.

Dim filePath As String
filePath = System.IO.Path.Combine( _
My.Computer.FileSystem.SpecialDirectories.MyDocuments, "test.txt")

Use o método WriteAllText para gravar texto para o arquivo especificado.
```
My.Computer.FileSystem.WriteAllText(filePath, "some text", True)
```

Exemplo

Try
    Dim filePath As String
    filePath = System.IO.Path.Combine( _
               My.Computer.FileSystem.SpecialDirectories.MyDocuments, "test.txt")
            My.Computer.FileSystem.WriteAllText(filePath, "some text", False)
Catch fileException As Exception
    Throw fileException
End Try

Compilando o código

Substitua test.txt pelo nome do arquivo você deseja para gravar.

Programação robusta

Este código joga todas as exceções que podem ocorrer ao gravar texto no arquivo.Você pode reduzir a probabilidade de exceções usando controles Windows Forms como o OpenFileDialog e o SaveFileDialog que limitam as opções de usuário para nomes de arquivo válido.Entretanto, usar esses controles é não à prova de falhas.O sistema de arquivos pode alterar entre o momento que o usuário seleciona um arquivo e a hora que ele executa o código.Manipulação de exceção é, portanto, quase sempre necessária quando se trabalha com arquivos.

Segurança

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

Este exemplo cria um novo arquivo.Se um aplicativo precisa criar um arquivo, esse aplicativo precisa criar permissão para a pasta.Permissões são feitas com listas de controle de acesso.Se o arquivo já existe, o aplicativo precisa somente escrever permissão, um privilégio menor.Quando possível, é mais seguro criar o arquivo durante a implantação e conceder privilégios para um único arquivo somente leitura e não para conceder privilégios de criação para uma pasta.Além disso, é mais seguro gravar dados em pastas de usuário que em pasta raiz ou em pasta Program Files.Para obter mais informações, consulte Listas de controle de acesso (ACLs).