Практическое руководство. Запись текста в файлы в каталоге "Мои документы" в Visual BasicHow to: Write Text to Files in the My Documents Directory in Visual Basic

Объект My.Computer.FileSystem.SpecialDirectories позволяет получить доступ к специальным каталогам, таким как каталог Мои документы.The My.Computer.FileSystem.SpecialDirectories object allows you to access special directories, such as the MyDocuments directory.

ПроцедураProcedure

Запись новых текстовых файлов в каталог "Мои документы"To write new text files in the My Documents directory

  1. Укажите путь в свойстве My.Computer.FileSystem.SpecialDirectories.MyDocuments.Use the My.Computer.FileSystem.SpecialDirectories.MyDocuments property to supply the path.

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

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

ПримерExample

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

Компиляция кодаCompiling the Code

Замените имя test.txt на имя файла, в который требуется выполнить запись.Replace test.txt with the name of the file you want to write to.

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

Этот код возвращает все исключения, которые могут произойти при записи текста в файл.This code rethrows all the exceptions that may occur when writing text to the file. Можно уменьшить вероятность возникновения исключений с помощью элементов управления Windows Forms, таких как компоненты OpenFileDialog и SaveFileDialog, которые позволяют пользователям выбирать только допустимые имена файлов.You can reduce the likelihood of exceptions by using Windows Forms controls such as the OpenFileDialog and the SaveFileDialog components that limit the user choices to valid file names. Однако использование этих элементов управления не гарантирует полную надежность.Using these controls is not foolproof, however. В период между моментом выбора пользователем файла и моментом выполнения кода файловая система может измениться.The file system can change between the time the user selects a file and the time that the code executes. Таким образом, при работе с файлами обработка исключений почти всегда является необходимой.Exception handling is therefore nearly always necessary when with working with files.

Безопасность .NET Framework.NET Framework Security

Если код выполняется в контексте частичного доверия, исключение может возникнуть из-за недостатка прав доступа.If you are running in a partial-trust context, the code might throw an exception due to insufficient privileges. Дополнительные сведения см. в разделе Code Access Security Basics.For more information, see Code Access Security Basics.

В этом примере создается новый файл.This example creates a new file. Если приложение создает файл, оно должно иметь разрешение на создание файла в соответствующем каталоге.If an application needs to create a file, that application needs Create permission for the folder. Для задания разрешений используются списки управления доступом.Permissions are set using access control lists. Если файл уже существует, приложению требуется лишь разрешение на запись (с более низким уровнем).If the file already exists, the application needs only Write permission, a lesser privilege. Для повышения безопасности рекомендуется по возможности создавать файлы во время развертывания и предоставлять доступ на чтение только к одному файлу, а не доступ к каталогу с разрешением на создание.Where possible, it is more secure to create the file during deployment, and only grant Read privileges to a single file, rather than to grant Create privileges for a folder. По тем же соображениям рекомендуется записывать данные в пользовательские папки, а не в корневую папку или папку Program Files.Also, it is more secure to write data to user folders than to the root folder or the Program Files folder. Дополнительные сведения см. в разделе Общие сведения о технологии ACL.For more information, see ACL Technology Overview.

См. также разделSee also