FileSystemProxy.WriteAllText Метод

Определение

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

Microsoft.VisualBasic.MyServices

Сборка:

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

Комментарии

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

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

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

Примечание

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

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

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

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

• Encoding
• WriteAllText(String, String, Boolean)
• Объекты (Visual Basic)
• Запись в файлы в Visual Basic

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

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

Примеры

В этом примере строка "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 .

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

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

• Encoding
• Объекты (Visual Basic)
• Запись в файлы в Visual Basic