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


FileSystemProxy.WriteAllText Метод

Определение

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

Перегрузки

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.

Исключения

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

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 .

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

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

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

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.

Исключения

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

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 .

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

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

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