System.IO.File.AppendAllLines 方法 (String, IEnumerable, Encoding)

方法描述

使用指定的编码向一个文件中追加文本行,然后关闭该文件。

语法定义(C# System.IO.File.AppendAllLines 方法 (String, IEnumerable, Encoding) 的用法)

public static void AppendAllLines(
	string path,
	IEnumerable contents,
	Encoding encoding
)

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
path System-String 要向其中追加文本行的文件。
contents System-Collections-Generic-IEnumerable 要追加到文件中的文本行。
encoding System-Text-Encoding 要使用的字符编码。
返回值 void

提示和注释

如果目标文件不存在,则创建该文件。

您可以使用此方法创建包含以下内容的文件:

对文件的行执行 LINQ to Objects 查询的结果,与使用 ReadLines 方法获得的结果相同。

实现字符串 IEnumerable 的集合的内容。

System.IO.File.AppendAllLines 方法 (String, IEnumerable, Encoding)例子


异常

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

命名空间

namespace: System.IO

程序集: mscorlib(在 mscorlib.dll 中)

版本信息

.NET Framework 受以下版本支持:4 .NET Framework Client Profile 受以下版本支持:4

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。