System.IO.File.AppendAllLines 方法 (String, IEnumerable, Encoding)
上一篇:System.IO.File.AppendAllLines(String,IEnumerable{String}) 方法
下一篇:System.IO.File.AppendAllText(String,String) 方法
方法描述
使用指定的编码向一个文件中追加文本行,然后关闭该文件。
语法定义(C# System.IO.File.AppendAllLines 方法 (String, IEnumerable, Encoding) 的用法)
public static void AppendAllLines( string path, IEnumerablecontents, 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 |
|
版本信息
.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 系统要求。
上一篇:System.IO.File.AppendAllLines(String,IEnumerable{String}) 方法
下一篇:System.IO.File.AppendAllText(String,String) 方法