FileSystemProxy.WriteAllText Метод

Ссылка

Определение

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

Сборка:: Microsoft.VisualBasic.dll

Сборка:: Microsoft.VisualBasic.Forms.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Записывает текст в файл.

Перегрузки

WriteAllText(String, String, Boolean)	Записывает текст в файл.
WriteAllText(String, String, Boolean, Encoding)	Записывает текст в файл.

WriteAllText(String, String, Boolean)

Записывает текст в файл.

public:
 void WriteAllText(System::String ^ file, System::String ^ text, bool append);

public void WriteAllText (string file, string text, bool append);

member this.WriteAllText : string * string * bool -> unit

Public Sub WriteAllText (file As String, text As String, append As Boolean)

Параметры

file: String

Файл, в который необходимо выполнить запись.

text: String

Текст, который необходимо записать в файл.

append: Boolean

True для добавления содержимого файла; False для перезаписи содержимого файла. Значение по умолчанию — False.

Исключения

ArgumentException

Путь недопустим по одной из следующих причин: это строка нулевой длины; содержит только пробелы; содержит недопустимые символы; или это путь к устройству (начинается с \\.\); заканчивается косой чертой.

ArgumentNullException

file имеет значение Nothing.

FileNotFoundException

Файл не существует.

IOException

Файл уже используется другим процессом или возникла ошибка ввода-вывода.

PathTooLongException

Длина пути превышает максимальную длину, определенную в системе.

NotSupportedException

Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.

OutOfMemoryException

Не хватает памяти для записи строки в буфер.

SecurityException

У пользователя отсутствуют необходимые разрешения на просмотр пути.

Примеры

В этом примере строка "This is new text to be added." записывается в файл Test.txt, перезаписывается любой существующий текст в файле.

My.Computer.FileSystem.WriteAllText("C:\TestFolder1\test.txt",
"This is new text to be added.", False)

В этом примере имена файлов в папке Documents and Settings записываются FileList.txtв , вставляя возврат каретки между ними для повышения удобочитаемости.

For Each foundFile In
        My.Computer.FileSystem.GetFiles("C:\Documents and Settings")
    foundFile = foundFile & vbCrLf
    My.Computer.FileSystem.WriteAllText(
        "C:\Documents and Settings\FileList.txt", foundFile, True)
Next

Метод WriteAllText открывает файл, записывает в него, а затем закрывает его. Код, использующий WriteAllText метод , проще, чем код, использующий StreamWriter объект . Однако при добавлении строк в файл с помощью цикла объект может обеспечить лучшую производительность, StreamWriter так как файл нужно открыть и закрыть только один раз. Дополнительные сведения см. в описании метода OpenTextFileWriter.

В следующей таблице перечислены примеры задач, связанных с методом My.Computer.FileSystem.WriteAllText .

Кому	См.
Запись текста в файл	Практическое руководство. Запись текста в файлы
Добавление текста в файл	Практическое руководство. Дозапись в текстовый файл

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

Применяется к

WriteAllText(String, String, Boolean, Encoding)

Записывает текст в файл.

public:
 void WriteAllText(System::String ^ file, System::String ^ text, bool append, System::Text::Encoding ^ encoding);

public void WriteAllText (string file, string text, bool append, System.Text.Encoding encoding);

member this.WriteAllText : string * string * bool * System.Text.Encoding -> unit

Public Sub WriteAllText (file As String, text As String, append As Boolean, encoding As Encoding)

Параметры

file: String

Файл, в который необходимо выполнить запись.

text: String

Текст, который необходимо записать в файл.

append: Boolean

True для добавления содержимого файла; False для перезаписи содержимого файла. Значение по умолчанию — False.

encoding: Encoding

Кодировка, которую необходимо использовать для записи в файл. По умолчанию — UTF-8.

Исключения

ArgumentException

ArgumentNullException

file имеет значение Nothing.

FileNotFoundException

Файл не существует.

IOException

Файл уже используется другим процессом или возникла ошибка ввода-вывода.

PathTooLongException

Длина пути превышает максимальную длину, определенную в системе.

NotSupportedException

Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.

OutOfMemoryException

Не хватает памяти для записи строки в буфер.

SecurityException

У пользователя отсутствуют необходимые разрешения на просмотр пути.

Примеры

My.Computer.FileSystem.WriteAllText("C:\TestFolder1\test.txt",
"This is new text to be added.", False)

For Each foundFile In
        My.Computer.FileSystem.GetFiles("C:\Documents and Settings")
    foundFile = foundFile & vbCrLf
    My.Computer.FileSystem.WriteAllText(
        "C:\Documents and Settings\FileList.txt", foundFile, True)
Next

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

Применяется к

Поделиться через

FileSystemProxy.WriteAllText Метод

Определение

Перегрузки

WriteAllText(String, String, Boolean)

Параметры

Исключения

Примеры

Комментарии

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

Применяется к

WriteAllText(String, String, Boolean, Encoding)

Параметры

Исключения

Примеры

Комментарии

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

Применяется к

Дополнительные ресурсы