FileSystem.WriteAllText Метод

Определение

Записывает текст в файл.Writes text to a file.

Перегрузки

WriteAllText(String, String, Boolean)

Записывает текст в файл.Writes text to a file.

WriteAllText(String, String, Boolean, Encoding)

Записывает текст в файл.Writes text to a file.

WriteAllText(String, String, Boolean)

Записывает текст в файл.Writes text to a file.

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

Файл, в который необходимо выполнить запись.File to be written to.

text
String

Текст, который необходимо записать в файл.Text to be written to file.

append
Boolean

True для добавления содержимого файла; False для перезаписи содержимого файла.True to append to the contents of the file; False to overwrite the contents of the file.

Исключения

Путь является недопустимым, так как либо представляет собой строку нулевой длины (пустую строку), либо содержит только пробел, либо содержит недопустимые символы, либо представляет собой путь к устройству (начинается с символов \\.\); заканчивается косой чертой.The path is not valid for one of the following reasons: it is a zero-length string; it contains only white space; it contains invalid characters; or it is a device path (starts with \\.\); it ends with a trailing slash.

file имеет значение Nothing.file is Nothing.

Файл не существует.The file does not exist.

Файл уже используется другим процессом или возникла ошибка ввода-вывода.The file is in use by another process, or an I/O error occurs.

Длина пути превышает максимальную длину, определенную в системе.The path exceeds the system-defined maximum length.

Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.A file or directory name in the path contains a colon (:) or is in an invalid format.

Не хватает памяти для записи строки в буфер.There is not enough memory to write the string to buffer.

У пользователя отсутствуют необходимые разрешения на просмотр пути.The user lacks necessary permissions to view the path.

Примеры

В этом примере строка записывается в "This is new text to be added." файл Test.txt , перезаписывая существующий текст в файле.This example writes the line "This is new text to be added." to the file Test.txt, overwriting any existing text in the file.

My.Computer.FileSystem.WriteAllText("C:\TestFolder1\test.txt",
"This is new text to be added.", False)

В этом примере имена файлов в папке записываются Documents and Settings в FileList.txt и вставляются символы возврата каретки между ними для повышения удобочитаемости.This example writes the names of the files in the Documents and Settings folder to FileList.txt, inserting a carriage return between each for better readability.

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 используется для записи в файл.The UTF-8 encoding is used to write to the file. Чтобы указать другую кодировку, используйте другую перегрузку WriteAllText метода.To specify a different encoding, use a different overload of the WriteAllText method.

Если заданный файл не существует, он будет создан.If the specified file does not exist, it is created.

Если указанная кодировка не совпадает с существующей кодировкой файла, указанное кодирование игнорируется.If the specified encoding does not match the existing encoding of the file, the specified coding is ignored.

Примечание

WriteAllTextМетод открывает файл, записывает его, а затем закрывает его.The WriteAllText method opens a file, writes to it, and then closes it. Код, использующий WriteAllText метод, проще, чем код, использующий StreamWriter объект.Code that uses the WriteAllText method is simpler than code that uses a StreamWriter object. Однако при добавлении строк в файл с помощью цикла StreamWriter объект может обеспечить лучшую производительность, так как необходимо только открыть и закрыть файл только один раз.However, if you are adding strings to a file by using a loop, a StreamWriter object can provide better performance because you only have to open and close the file one time. Дополнительные сведения см. в описании метода OpenTextFileWriter.For more information, see the OpenTextFileWriter method.

В следующей таблице приведены примеры задач, в которых используется My.Computer.FileSystem.WriteAllText метод.The following table lists examples of tasks involving the My.Computer.FileSystem.WriteAllText method.

КомуTo См.See
Запись текста в файлWrite text to a file Практическое руководство. Запись текста в файлы в Visual BasicHow to: Write Text to Files in Visual Basic
Добавление текста в файлAppend text to a file Практическое руководство. Дозапись в текстовый файл в Visual BasicHow to: Append to Text Files in Visual Basic

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

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

WriteAllText(String, String, Boolean, Encoding)

Записывает текст в файл.Writes text to a file.

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

Файл, в который необходимо выполнить запись.File to be written to.

text
String

Текст, который необходимо записать в файл.Text to be written to file.

append
Boolean

True для добавления содержимого файла; False для перезаписи содержимого файла.True to append to the contents of the file; False to overwrite the contents of the file.

encoding
Encoding

Кодировка, которую необходимо использовать для записи в файл.What encoding to use when writing to file.

Исключения

Путь является недопустимым, так как либо представляет собой строку нулевой длины (пустую строку), либо содержит только пробел, либо содержит недопустимые символы, либо представляет собой путь к устройству (начинается с символов \\.\); заканчивается косой чертой.The path is not valid for one of the following reasons: it is a zero-length string; it contains only white space; it contains invalid characters; or it is a device path (starts with \\.\); it ends with a trailing slash.

file имеет значение Nothing.file is Nothing.

Файл не существует.The file does not exist.

Файл уже используется другим процессом или возникла ошибка ввода-вывода.The file is in use by another process, or an I/O error occurs.

Длина пути превышает максимальную длину, определенную в системе.The path exceeds the system-defined maximum length.

Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.A file or directory name in the path contains a colon (:) or is in an invalid format.

Не хватает памяти для записи строки в буфер.There is not enough memory to write the string to buffer.

У пользователя отсутствуют необходимые разрешения на просмотр пути.The user lacks necessary permissions to view the path.

Примеры

В этом примере строка записывается в "This is new text to be added." файл Test.txt , перезаписывая существующий текст в файле.This example writes the line "This is new text to be added." to the file Test.txt, overwriting any existing text in the file.

My.Computer.FileSystem.WriteAllText("C:\TestFolder1\test.txt",
"This is new text to be added.", False)

В этом примере имена файлов в папке записываются Documents and Settings в FileList.txt и вставляются символы возврата каретки между ними для повышения удобочитаемости.This example writes the names of the files in the Documents and Settings folder to FileList.txt, inserting a carriage return between each for better readability.

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

Комментарии

Если заданный файл не существует, он будет создан.If the specified file does not exist, it is created.

Если указанная кодировка не совпадает с существующей кодировкой файла, указанное кодирование игнорируется.If the specified encoding does not match the existing encoding of the file, the specified coding is ignored.

Примечание

WriteAllTextМетод открывает файл, записывает его, а затем закрывает его.The WriteAllText method opens a file, writes to it, and then closes it. Код, использующий WriteAllText метод, проще, чем код, использующий StreamWriter объект.Code that uses the WriteAllText method is simpler than code that uses a StreamWriter object. Однако при добавлении строк в файл с помощью цикла StreamWriter объект может обеспечить лучшую производительность, так как необходимо только открыть и закрыть файл только один раз.However, if you are adding strings to a file by using a loop, a StreamWriter object can provide better performance because you only have to open and close the file one time. Дополнительные сведения см. в описании метода OpenTextFileWriter.For more information, see the OpenTextFileWriter method.

В следующей таблице приведены примеры задач, в которых используется My.Computer.FileSystem.WriteAllText метод.The following table lists examples of tasks involving the My.Computer.FileSystem.WriteAllText method.

КомуTo См.See
Запись текста в файлWrite text to a file Практическое руководство. Запись текста в файлы в Visual BasicHow to: Write Text to Files in Visual Basic
Добавление текста в файлAppend text to a file Практическое руководство. Дозапись в текстовый файл в Visual BasicHow to: Append to Text Files in Visual Basic

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

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