FileSystem.WriteAllText Метод

Определение

Пространство имен:

Microsoft.VisualBasic.FileIO

Сборка:

Microsoft.VisualBasic.Core.dll

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

Перегрузки

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

WriteAllText(String, String, Boolean)

Исходный код:

FileSystem.vb

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

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

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

static member WriteAllText : string * string * bool -> unit

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

Параметры

file

String

Файл для записи.

text

String

Текст для записи в файл.

append

Boolean

True для добавления к содержимому файла; 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 SettingsFileList.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

Комментарии

Кодировка UTF-8 используется для записи в файл. Чтобы указать другую кодировку, используйте другую перегрузку WriteAllText метода.

Если указанный файл не существует, он создается.

Если указанная кодировка не соответствует существующей кодировке файла, указанный код игнорируется.

Note

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

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

Кому	Смотри
Запись текста в файл	How to: Write Text to Files in Visual Basic
Добавление текста в файл	How to: Добавление в текстовые файлы в Visual Basic

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

• Encoding
• WriteAllText

WriteAllText(String, String, Boolean, Encoding)

Исходный код:

FileSystem.vb

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

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

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

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

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

Параметры

file

String

Файл для записи.

text

String

Текст для записи в файл.

append

Boolean

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

encoding

Encoding

Какую кодировку следует использовать при записи в файл.

Исключения

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 SettingsFileList.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

Комментарии

Если указанный файл не существует, он создается.

Если указанная кодировка не соответствует существующей кодировке файла, указанный код игнорируется.

Note

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

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

Кому	Смотри
Запись текста в файл	How to: Write Text to Files in Visual Basic
Добавление текста в файл	How to: Добавление в текстовые файлы в Visual Basic

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

• Encoding