FileSystem.WriteAllText Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Записывает текст в файл.
Перегрузки
| WriteAllText(String, String, Boolean) |
Записывает текст в файл. |
| WriteAllText(String, String, Boolean, Encoding) |
Записывает текст в файл. |
WriteAllText(String, String, Boolean)
- Исходный код:
- FileSystem.vb
- Исходный код:
- FileSystem.vb
- Исходный код:
- 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 -> unitPublic Shared Sub WriteAllText (file As String, text As String, append As Boolean)Параметры
- file
- String
Файл, в который необходимо выполнить запись.
- text
- String
Текст, который необходимо записать в файл.
- append
- Boolean
True для добавления содержимого файла; False для перезаписи содержимого файла.
Исключения
Путь недопустим по одной из следующих причин: это строка нулевой длины; содержит только пробелы; содержит недопустимые символы; или это путь к устройству (начинается с \\.\); заканчивается косой чертой в конце.
file имеет значение Nothing.
Файл не существует.
Файл уже используется другим процессом или возникла ошибка ввода-вывода.
Длина пути превышает максимальную длину, определенную в системе.
Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.
Не хватает памяти для записи строки в буфер.
У пользователя отсутствуют необходимые разрешения на просмотр пути.
Примеры
В этом примере строка "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 |
См. также раздел
Применяется к
WriteAllText(String, String, Boolean, Encoding)
- Исходный код:
- FileSystem.vb
- Исходный код:
- FileSystem.vb
- Исходный код:
- 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 -> unitPublic 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
Кодировка, которую необходимо использовать для записи в файл.
Исключения
Путь недопустим по одной из следующих причин: это строка нулевой длины; содержит только пробелы; содержит недопустимые символы; или это путь к устройству (начинается с \\.\); заканчивается косой чертой в конце.
file имеет значение Nothing.
Файл не существует.
Файл уже используется другим процессом или возникла ошибка ввода-вывода.
Длина пути превышает максимальную длину, определенную в системе.
Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.
Не хватает памяти для записи строки в буфер.
У пользователя отсутствуют необходимые разрешения на просмотр пути.
Примеры
В этом примере строка "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 |
