File.AppendAllText Метод

Определение

Добавляет указанную строку в файл, создавая файл, если он не существует.Appends the specified string to the file, creating the file if it does not already exist.

Перегрузки

AppendAllText(String, String)

Открывает файл, добавляет в него указанную строку и затем закрывает файл.Opens a file, appends the specified string to the file, and then closes the file. Если файл не существует, этот метод создает файл, записывает в него указанную строку и затем закрывает файл.If the file does not exist, this method creates a file, writes the specified string to the file, then closes the file.

AppendAllText(String, String, Encoding)

Добавляет указанную строку в файл в указанной кодировке, создавая файл, если он не существует.Appends the specified string to the file using the specified encoding, creating the file if it does not already exist.

AppendAllText(String, String)

Открывает файл, добавляет в него указанную строку и затем закрывает файл.Opens a file, appends the specified string to the file, and then closes the file. Если файл не существует, этот метод создает файл, записывает в него указанную строку и затем закрывает файл.If the file does not exist, this method creates a file, writes the specified string to the file, then closes the file.

public:
 static void AppendAllText(System::String ^ path, System::String ^ contents);
public static void AppendAllText (string path, string contents);
static member AppendAllText : string * string -> unit
Public Shared Sub AppendAllText (path As String, contents As String)

Параметры

path
String

Файл, в который нужно добавить заданную строку.The file to append the specified string to.

contents
String

Строка, которую нужно добавить в файл.The string to append to the file.

Исключения

path представляет собой строку нулевой длины, содержащую только пробелы или один или несколько недопустимых символов, заданных методом InvalidPathChars.path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

pathnull.path is null.

Указанный путь, имя файла или оба значения превышают максимальную длину, заданную в системе.The specified path, file name, or both exceed the system-defined maximum length.

Указанный путь является недопустимым (например, каталог не существует или находится на несопоставленном диске).The specified path is invalid (for example, the directory doesn't exist or it is on an unmapped drive).

При открытии файла произошла ошибка ввода-вывода.An I/O error occurred while opening the file.

Параметр path указывает файл, доступный только для чтения.path specified a file that is read-only.

- или --or- Эта операция не поддерживается на текущей платформе.This operation is not supported on the current platform.

- или --or- Параметрpath определяет каталог.path specified a directory.

- или --or- У вызывающего объекта отсутствует необходимое разрешение.The caller does not have the required permission.

Параметр path задан в недопустимом формате.path is in an invalid format.

У вызывающего объекта отсутствует необходимое разрешение.The caller does not have the required permission.

Примеры

В следующем примере кода показано использование метода AppendAllText для добавления дополнительного текста в конец файла.The following code example demonstrates the use of the AppendAllText method to add extra text to the end of a file. В этом примере файл создается, если он еще не существует, и в него добавляется текст.In this example, a file is created if it doesn't already exist, and text is added to it. Однако для успешного выполнения примера каталог с именем temp на диске C должен существовать.However, the directory named temp on drive C must exist for the example to complete successfully.

using System;
using System.IO;
using System.Text;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";

        // This text is added only once to the file.
        if (!File.Exists(path))
        {
            // Create a file to write to.
            string createText = "Hello and Welcome" + Environment.NewLine;
            File.WriteAllText(path, createText);
        }

        // This text is always added, making the file longer over time
        // if it is not deleted.
        string appendText = "This is extra text" + Environment.NewLine;
        File.AppendAllText(path, appendText);

        // Open the file to read from.
        string readText = File.ReadAllText(path);
        Console.WriteLine(readText);
    }
}
Imports System.IO
Imports System.Text

Public Class Test
    Public Shared Sub Main()
        Dim path As String = "c:\temp\MyTest.txt"

        ' This text is added only once to the file.
        If File.Exists(path) = False Then

            ' Create a file to write to.
            Dim createText As String = "Hello and Welcome" + Environment.NewLine
            File.WriteAllText(path, createText)
        End If

        ' This text is always added, making the file longer over time
        ' if it is not deleted.
        Dim appendText As String = "This is extra text" + Environment.NewLine
        File.AppendAllText(path, appendText)

        ' Open the file to read from.
        Dim readText As String = File.ReadAllText(path)
        Console.WriteLine(readText)
    End Sub
End Class

Комментарии

При наличии строки и пути к файлу этот метод открывает указанный файл, добавляет строку в конец файла, а затем закрывает файл.Given a string and a file path, this method opens the specified file, appends the string to the end of the file, and then closes the file. Этот метод гарантированно закрывает этот файл, даже если возникают исключения.The file handle is guaranteed to be closed by this method, even if exceptions are raised.

Метод создает файл, если он не существует, но не создает новые каталоги.The method creates the file if it doesn't exist, but it doesn't create new directories. Поэтому значение параметра path должно содержать существующие каталоги.Therefore, the value of the path parameter must contain existing directories.

Безопасность

FileIOPermission
для доступа к записи в файл или каталог.for access to write to a file or directory. Связанное перечисление: AppendAssociated enumeration: Append

AppendAllText(String, String, Encoding)

Добавляет указанную строку в файл в указанной кодировке, создавая файл, если он не существует.Appends the specified string to the file using the specified encoding, creating the file if it does not already exist.

public:
 static void AppendAllText(System::String ^ path, System::String ^ contents, System::Text::Encoding ^ encoding);
public static void AppendAllText (string path, string contents, System.Text.Encoding encoding);
static member AppendAllText : string * string * System.Text.Encoding -> unit

Параметры

path
String

Файл, в который нужно добавить заданную строку.The file to append the specified string to.

contents
String

Строка, которую нужно добавить в файл.The string to append to the file.

encoding
Encoding

Кодировка символов, которую нужно использовать.The character encoding to use.

Исключения

path представляет собой строку нулевой длины, содержащую только пробелы или один или несколько недопустимых символов, заданных методом InvalidPathChars.path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

Свойство path имеет значение null.path is null.

Указанный путь, имя файла или оба значения превышают максимальную длину, заданную в системе.The specified path, file name, or both exceed the system-defined maximum length.

Указанный путь является недопустимым (например, каталог не существует или находится на несопоставленном диске).The specified path is invalid (for example, the directory doesn't exist or it is on an unmapped drive).

При открытии файла произошла ошибка ввода-вывода.An I/O error occurred while opening the file.

Параметр path указывает файл, доступный только для чтения.path specified a file that is read-only.

- или --or- Эта операция не поддерживается на текущей платформе.This operation is not supported on the current platform.

- или --or- Параметрpath определяет каталог.path specified a directory.

- или --or- У вызывающего объекта отсутствует необходимое разрешение.The caller does not have the required permission.

Параметр path задан в недопустимом формате.path is in an invalid format.

У вызывающего объекта отсутствует необходимое разрешение.The caller does not have the required permission.

Примеры

В следующем примере кода показано использование метода AppendAllText для добавления дополнительного текста в конец файла.The following code example demonstrates the use of the AppendAllText method to add extra text to the end of a file. В этом примере файл создается, если он еще не существует, и в него добавляется текст.In this example, a file is created if it doesn't already exist, and text is added to it. Однако для успешного выполнения примера каталог с именем temp на диске C должен существовать.However, the directory named temp on drive C must exist for the example to complete successfully.

using System;
using System.IO;
using System.Text;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";

        // This text is added only once to the file.
        if (!File.Exists(path))
        {
            // Create a file to write to.
            string createText = "Hello and Welcome" + Environment.NewLine;
            File.WriteAllText(path, createText, Encoding.UTF8);
        }

        // This text is always added, making the file longer over time
        // if it is not deleted.
        string appendText = "This is extra text" + Environment.NewLine;
        File.AppendAllText(path, appendText, Encoding.UTF8);

        // Open the file to read from.
        string readText = File.ReadAllText(path);
        Console.WriteLine(readText);
    }
}
Imports System.IO
Imports System.Text

Public Class Test
    Public Shared Sub Main()
        Dim path As String = "c:\temp\MyTest.txt"
        Dim sw As StreamWriter

        ' This text is added only once to the file.
        If File.Exists(path) = False Then

            ' Create a file to write to.
            Dim createText As String = "Hello and Welcome" + Environment.NewLine
            File.WriteAllText(path, createText, Encoding.UTF8)
        End If

        ' This text is always added, making the file longer over time
        ' if it is not deleted.
        Dim appendText As String = "This is extra text" + Environment.NewLine
        File.AppendAllText(path, appendText, Encoding.UTF8)

        ' Open the file to read from.
        Dim readText As String = File.ReadAllText(path)
        Console.WriteLine(readText)
    End Sub
End Class

Комментарии

При наличии строки и пути к файлу этот метод открывает указанный файл, добавляет строку в конец файла, используя указанную кодировку, а затем закрывает файл.Given a string and a file path, this method opens the specified file, appends the string to the end of the file using the specified encoding, and then closes the file. Этот метод гарантированно закрывает этот файл, даже если возникают исключения.The file handle is guaranteed to be closed by this method, even if exceptions are raised.

Метод создает файл, если он не существует, но не создает новые каталоги.The method creates the file if it doesn't exist, but it doesn't create new directories. Поэтому значение параметра path должно содержать существующие каталоги.Therefore, the value of the path parameter must contain existing directories.

Безопасность

FileIOPermission
для доступа к записи в файл или каталог.for access to write to a file or directory. Связанное перечисление: AppendAssociated enumeration: Append

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