Compartilhar via


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

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

Procedimento

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

  1. 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")
    
  2. Use o método WriteAllText para escrever o texto no 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 no qual você deseja gravar.

Programação robusta

Esse código lança novamente todas as exceções que podem ocorrer ao gravar texto no arquivo. É possível reduzir a probabilidade de exceções usando controles do Windows Forms como os componentes OpenFileDialogSaveFileDialog que limitam as escolhas do usuário para validar nomes de arquivo. No entanto, o uso desses controles não é à prova de falhas. O sistema de arquivos pode ser alterado entre o momento em que o usuário seleciona um arquivo e o momento em que o código é executado. Portanto, o tratamento de exceções é quase sempre é necessário ao trabalhar com arquivos.

Segurança do .NET Framework

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.

Esse exemplo cria um novo arquivo. Se um aplicativo precisar criar um arquivo, esse aplicativo precisará da permissão de criação para a pasta. As permissões são definidas usando listas de controle de acesso. Se o arquivo já existir, o aplicativo precisará somente da permissão de gravação, um privilégio menor. Sempre que possível, é mais seguro criar o arquivo durante a implantação e somente conceder privilégios de leitura para um único arquivo, em vez de conceder privilégios de criação para uma pasta. Além disso, é mais seguro gravar dados em pastas de usuário do que na pasta raiz ou na pasta Arquivos de Programas. Para obter mais informações, consulte Visão Geral da Tecnologia de ACL.

Confira também