c# -- 介绍File.AppendAllText 方法

下面介绍两个函数：

• File.AppendAllText (String, String)

• File.AppendAllText (String, String, String)

File.AppendAllText 方法 (String, String)

函数说明:打开一个文件，向其中追加指定的字符串，然后关闭该文件。 如果文件不存在，此方法创建一个文件，将指定的字符串写入文件，然后关闭该文件。

命名空间：  System.IO
程序集：  mscorlib（在 mscorlib.dll 中）

语法:

public static void AppendAllText(
    string path,
    string contents
)

参数说明:

path

类型：System.String，要将指定的字符串追加到的文件。

contents

类型：System.String， 要追加到文件中的字符串。

代码示例:

下面的代码示例演示如何使用 AppendAllText 方法将额外的文本添加到文件末尾。 在此示例中，该文件后，如果它已不存在，并且，文本添加到。

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);
    }
}

• 注意点:

已知字符串和文件路径，此方法打开指定的文件，将字符串追加到文件末尾，然后关闭文件。 即使会引发异常，也使用此方法保证文件句柄已关闭。

方法创建文件，如果不存在，则，但不创建新目录。 因此，path 参数的值必须包含现有内容。

File.AppendAllText(String, String, Encoding)

函数说明:将指定的字符串追加到文件中，如果文件还不存在则创建该文件。

命名空间：  System.IO
程序集：  mscorlib（在 mscorlib.dll 中）

语法:

public static void AppendAllText(
    string path,
    string contents,
    Encoding encoding
)

参数说明:

path

类型：System.String，要将指定的字符串追加到的文件。

contents

类型：System.String，要追加到文件中的字符串。

encoding

类型：System.Text.Encoding，要使用的字符编码。

用法：

File.AppendAllText(path, contents, Encoding)

如：File.AppendAllText(path, appendText, Encoding.UTF8);

• 附录:异常表

异常	条件
ArgumentException	path 是一个零长度字符串，仅包含空白或者包含一个或多个由 InvalidPathChars 定义的无效字符。
ArgumentNullException	path 为 null。
PathTooLongException	指定的路径、文件名或者两者都超出了系统定义的最大长度。 例如，在基于 Windows 的平台上，路径必须小于 248 个字符，文件名必须小于 260 个字符。
DirectoryNotFoundException	指定路径无效（例如，目录不存在或位于未映射的驱动器上）。
IOException	打开文件时发生 I/O 错误。
UnauthorizedAccessException	path 指定了一个只读文件。 - 或 - 在当前平台上不支持此操作。 - 或 - path 指定了一个目录。 - 或 - 调用方没有所要求的权限。
FileNotFoundException	未找到 path 中指定的文件。
NotSupportedException	path 的格式无效。
SecurityException	调用方没有所要求的权限。

• Learn From: http://msdn.microsoft.com/zh-cn/library/System.IO.File_methods(v=vs.110).aspx