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

Комментарии

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

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

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

Примечание

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

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

Кому	См.
Запись текста в файл	Практическое руководство. Запись текста в файлы в Visual Basic
Добавление текста в файл	Практическое руководство. Дозапись в текстовый файл в 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 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 .

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

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

• Encoding