Практическое руководство. Запись текста в файлы в каталоге "Мои Документы" в Visual Basic

Обновлен: Ноябрь 2007

Объект My.Computer.FileSystem.SpecialDirectories позволяет получать доступ к специальным каталогам, таким как каталог Мои документы.

Процедура

Чтобы записать новые текстовые файлы в каталог "Мои документы"

  1. Укажите путь в свойстве My.Computer.FileSystem.SpecialDirectories.MyDocuments.

    Dim filePath As String
    filePath = System.IO.Path.Combine( _
    My.Computer.FileSystem.SpecialDirectories.MyDocuments, "test.txt")
    
  2. Используйте метод WriteAllText для записи текста в указанный файл.

    My.Computer.FileSystem.WriteAllText(filePath, "some text", True)
    

Пример

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

Компиляция кода

Замените имя test.txt на имя файла, в который требуется выполнить запись.

Отказоустойчивость

Этот код возвращает все исключения, которые могут произойти при записи текста в файл. Можно уменьшить вероятность возникновения исключений, используя элементы управления Windows Forms, такие как компоненты OpenFileDialog и SaveFileDialog, которые позволяют пользователям выбирать только допустимые имена файлов. Однако использование этих элементов управления не гарантирует полную надежность. В период между моментом выбора пользователем файла и моментом выполнения кода файловая система может измениться. Таким образом, при работе с файлами обработка исключений почти всегда является необходимой.

Безопасность

Если код выполняется в контексте частичного доверия, исключение может произойти из-за недостатка прав доступа. Дополнительные сведения см. в разделе Основы управления доступом для кода.

В этом примере создается новый файл. Если приложение создает файл, оно должно иметь разрешение на создание файла в соответствующем каталоге. Для задания разрешений используется список управления доступом. Если файл уже существует, приложению требуется лишь разрешение на запись. Для повышения безопасности рекомендуется по возможности создавать файлы во время развертывания и предоставлять доступ на чтение только к одному файлу, а не доступ к каталогу с разрешением на создание. По тем же соображениям рекомендуется сохранять данные в пользовательских каталогах, а не в корневом каталоге или каталоге Program Files. Дополнительные сведения см. в разделе Списки управления доступом (ACL).

См. также

Ссылки

Path.Combine

Объект My.Computer

Объект My.Computer.FileSystem

Метод My.Computer.FileSystem.WriteAllText

Объект My.Computer.FileSystem.SpecialDirectories