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

Статья
11/05/2008

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

Открывает StreamWriter.

' Usage
Dim value As System.IO.StreamWriter = My.Computer.FileSystem.OpenTextFileWriter(file ,append)
Dim value As System.IO.StreamWriter = My.Computer.FileSystem.OpenTextFileWriter(file ,append ,encoding)
' Declaration
Public Function OpenTextFileWriter( _
   ByVal file As String, _
   ByVal append As Boolean _
) As System.IO.StreamWriter
' -or-
Public Function OpenTextFileWriter( _
   ByVal file As String, _
   ByVal append As Boolean, _
   ByVal encoding As System.Text.Encoding _
) As System.IO.StreamWriter

Параметры

file
String. Файл для записи. Обязательный параметр.
append
Boolean. Указывает, следует ли добавить данные в файл, либо перезаписать данные, уже имеющиеся в нем. Обязательный параметр.
encoding
Encoding. Кодировка, которую необходимо использовать при записи в файл. По умолчанию используется значение UTF8.

Возвращаемое значение

StreamWriter

Исключения

Следующее условие может вызвать исключение:

Имя файла оканчивается концевой косой чертой (ArgumentException).

Заметки

Метод OpenTextFileWriter открывает и инициализирует поток для файла, а затем возвращает объект StreamWriter для этого потока. Можно записывать в поток столько раз, сколько необходимо; после окончания его следует закрыть.

Примечание.
Необходимо вызвать метод Close объекта StreamWriter, чтобы убедиться, что все данные правильно записываются в основной поток.

Если для параметра append установлено значение True, то метод добавит текст к файлу; в противном случае будет перезаписан существующий текст в файле.

При записывании лишь нескольких строк в файл, возможно, проще использовать метод WriteAllText. Дополнительные сведения см. в разделе Метод My.Computer.FileSystem.WriteAllText.

Задачи

В следующей таблице содержится пример задачи, в которой используется метод My.Computer.FileSystem.OpenTextFileWriter.

To	См. в разделе
Запись текста в файл с помощью StreamWriter	Практическое руководство. Запись текста в файлы с помощью StreamWriter в Visual Basic

Пример

В этом примере файл StreamWriter открывается посредством метода My.Computer.FileSystem.OpenTextFileWriter и использует его для записи строки в текстовый файл с помощью метода WriteLine класса StreamWriter.

Dim file As System.IO.StreamWriter
file = My.Computer.FileSystem.OpenTextFileWriter("c:\test.txt", True)
file.WriteLine("Here is the first string.")
file.Close()

Требования

Пространство имен:Microsoft.VisualBasic.MyServices

Класс:FileSystemProxy (предоставляет доступ к FileSystem)

Сборка: библиотека времени выполнения Visual Basic (в Microsoft.VisualBasic.dll)

Доступность по типу проекта

Тип проекта	Доступность
Приложение Windows	Да
Библиотека классов	Да
Консольное приложение	Да
Библиотека элементов управления Windows	Да
Библиотека веб-элементов управления	Да
Служба Windows	Да
Веб-узел	Да

Разрешения

Могут потребоваться следующие разрешения:

Разрешение	Описание
FileIOPermission	Определяет возможность доступа к файлам или папкам. Связанное перечисление: Unrestricted.