#region 程序集 mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
// C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.5\mscorlib.dll
#endregion
using System.Collections.Generic;
using System.Runtime.InteropServices;
using System.Security;
using System.Security.AccessControl;
using System.Text;
namespace System.IO
{
//
// 摘要:
// 提供用于创建、复制、删除、移动和打开单一文件的静态方法,并协助创建 System.IO.FileStream 对象。若要浏览此类型的.NET Framework
// 源代码,请参阅 Reference Source。
[ComVisible(true)]
public static class File
{
//
// 摘要:
// 向一个文件中追加行,然后关闭该文件。 如果指定文件不存在,此方法会创建一个文件,向其中写入指定的行,然后关闭该文件。
//
// 参数:
// path:
// 要向其中追加行的文件。 如果文件尚不存在,则创建该文件。
//
// contents:
// 要追加到文件中的行。
//
// 异常:
// T:System.ArgumentException:
// path 为长度为零的字符串,仅包含空白,或包含 System.IO.Path.GetInvalidPathChars 方法定义的一个或多个无效字符。
//
// T:System.ArgumentNullException:
// path 或 contents 之一是 null。
//
// T:System.IO.DirectoryNotFoundException:
// path 无效(例如,目录不存在或在未映射的驱动器上)。
//
// T:System.IO.FileNotFoundException:
// 未找到 path 指定的文件。
//
// T:System.IO.IOException:
// 打开文件时发生 I/O 错误。
//
// T:System.IO.PathTooLongException:
// path 超出系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.NotSupportedException:
// path 的格式无效。
//
// T:System.Security.SecurityException:
// 调用方没有写入到文件中的权限。
//
// T:System.UnauthorizedAccessException:
// path 指定只读文件。- 或 -当前平台不支持此操作。- 或 -path 是一个目录。
public static void AppendAllLines(string path, IEnumerable<string> contents);
//
// 摘要:
// 使用指定的编码向一个文件中追加行,然后关闭该文件。 如果指定文件不存在,此方法会创建一个文件,向其中写入指定的行,然后关闭该文件。
//
// 参数:
// path:
// 要向其中追加行的文件。 如果文件尚不存在,则创建该文件。
//
// contents:
// 要追加到文件中的行。
//
// encoding:
// 要使用的字符编码。
//
// 异常:
// T:System.ArgumentException:
// path 为长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.GetInvalidPathChars 方法定义的无效字符。
//
// T:System.ArgumentNullException:
// path、contents 或 encoding 为 null。
//
// T:System.IO.DirectoryNotFoundException:
// path 无效(例如,目录不存在或在未映射的驱动器上)。
//
// T:System.IO.FileNotFoundException:
// 未找到 path 指定的文件。
//
// T:System.IO.IOException:
// 打开文件时发生 I/O 错误。
//
// T:System.IO.PathTooLongException:
// path 超出系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.NotSupportedException:
// path 的格式无效。
//
// T:System.Security.SecurityException:
// 调用方没有所要求的权限。
//
// T:System.UnauthorizedAccessException:
// path 指定只读文件。- 或 -当前平台不支持此操作。- 或 -path 是一个目录。- 或 -调用方没有所要求的权限。
public static void AppendAllLines(string path, IEnumerable<string> contents, Encoding encoding);
//
// 摘要:
// 将指定的字符串追加到文件中,如果文件还不存在则创建该文件。
//
// 参数:
// path:
// 要将指定的字符串追加到的文件。
//
// contents:
// 要追加到文件中的字符串。
//
// encoding:
// 要使用的字符编码。
//
// 异常:
// T:System.ArgumentException:
// path 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// T:System.ArgumentNullException:
// path 为 null。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路径无效(例如,目录不存在或在未映射的驱动器上)。
//
// T:System.IO.IOException:
// 打开文件时发生 I/O 错误。
//
// T:System.UnauthorizedAccessException:
// path 指定了一个只读文件。- 或 - 当前平台不支持此操作。- 或 - path 指定了一个目录。- 或 - 调用方没有所要求的权限。
//
// T:System.NotSupportedException:
// path 的格式无效。
//
// T:System.Security.SecurityException:
// 调用方没有所要求的权限。
public static void AppendAllText(string path, string contents, Encoding encoding);
//
// 摘要:
// 打开一个文件,向其中追加指定的字符串,然后关闭该文件。 如果文件不存在,此方法将创建一个文件,将指定的字符串写入文件,然后关闭该文件。
//
// 参数:
// path:
// 要将指定的字符串追加到的文件。
//
// contents:
// 要追加到文件中的字符串。
//
// 异常:
// T:System.ArgumentException:
// path 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// T:System.ArgumentNullException:
// path 为 null。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路径无效(例如,目录不存在或在未映射的驱动器上)。
//
// T:System.IO.IOException:
// 打开文件时发生 I/O 错误。
//
// T:System.UnauthorizedAccessException:
// path 指定了一个只读文件。- 或 - 当前平台不支持此操作。- 或 - path 指定了一个目录。- 或 - 调用方没有所要求的权限。
//
// T:System.NotSupportedException:
// path 的格式无效。
//
// T:System.Security.SecurityException:
// 调用方没有所要求的权限。
public static void AppendAllText(string path, string contents);
//
// 摘要:
// 创建一个 System.IO.StreamWriter,它将 UTF-8 编码文本追加到现有文件或新文件(如果指定文件不存在)。
//
// 参数:
// path:
// 要向其中追加内容的文件的路径。
//
// 返回结果:
// 一个流写入器,它将 UTF-8 编码文本追加到指定文件或新文件。
//
// 异常:
// T:System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
//
// T:System.ArgumentException:
// path 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// T:System.ArgumentNullException:
// path 为 null。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路径无效(例如,目录不存在或在未映射的驱动器上)。
//
// T:System.NotSupportedException:
// path 的格式无效。
public static StreamWriter AppendText(string path);
//
// 摘要:
// 将现有文件复制到新文件。 不允许覆盖同名的文件。
//
// 参数:
// sourceFileName:
// 要复制的文件。
//
// destFileName:
// 目标文件的名称。 它不能是一个目录或现有文件。
//
// 异常:
// T:System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
//
// T:System.ArgumentException:
// sourceFileName 或 destFileName 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars
// 定义的无效字符。- 或 - sourceFileName 或 destFileName 指定目录。
//
// T:System.ArgumentNullException:
// sourceFileName 或 destFileName 为 null。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.IO.DirectoryNotFoundException:
// sourceFileName 或 destFileName 中指定的路径无效(例如,它位于未映射的驱动器上)。
//
// T:System.IO.FileNotFoundException:
// 未找到 sourceFileName。
//
// T:System.IO.IOException:
// destFileName 已存在。- 或 - 发生了 I/O 错误。
//
// T:System.NotSupportedException:
// sourceFileName 或 destFileName 的格式无效。
public static void Copy(string sourceFileName, string destFileName);
//
// 摘要:
// 将现有文件复制到新文件。 允许覆盖同名的文件。
//
// 参数:
// sourceFileName:
// 要复制的文件。
//
// destFileName:
// 目标文件的名称。 不能是目录。
//
// overwrite:
// 如果可以覆盖目标文件,则为 true;否则为 false。
//
// 异常:
// T:System.UnauthorizedAccessException:
// 调用方没有所要求的权限。- 或 -destFileName 是只读。
//
// T:System.ArgumentException:
// sourceFileName 或 destFileName 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars
// 定义的无效字符。- 或 - sourceFileName 或 destFileName 指定目录。
//
// T:System.ArgumentNullException:
// sourceFileName 或 destFileName 为 null。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.IO.DirectoryNotFoundException:
// sourceFileName 或 destFileName 中指定的路径无效(例如,它位于未映射的驱动器上)。
//
// T:System.IO.FileNotFoundException:
// 未找到 sourceFileName。
//
// T:System.IO.IOException:
// destFileName 存在且 overwrite 是 false。- 或 - 发生了 I/O 错误。
//
// T:System.NotSupportedException:
// sourceFileName 或 destFileName 的格式无效。
public static void Copy(string sourceFileName, string destFileName, bool overwrite);
//
// 摘要:
// 在指定路径中创建或覆盖文件。
//
// 参数:
// path:
// 要创建的文件的路径及名称。
//
// 返回结果:
// 一个 System.IO.FileStream,它提供对 path 中指定的文件的读/写访问。
//
// 异常:
// T:System.UnauthorizedAccessException:
// 调用方没有所要求的权限。- 或 - path 指定了一个只读文件。
//
// T:System.ArgumentException:
// path 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// T:System.ArgumentNullException:
// path 为 null。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路径无效(例如,它位于未映射的驱动器上)。
//
// T:System.IO.IOException:
// 创建文件时发生 I/O 错误。
//
// T:System.NotSupportedException:
// path 的格式无效。
public static FileStream Create(string path);
//
// 摘要:
// 创建或覆盖指定的文件。
//
// 参数:
// path:
// 文件的名称。
//
// bufferSize:
// 用于读取和写入到文件的已放入缓冲区的字节数。
//
// 返回结果:
// 一个具有指定缓冲区大小的 System.IO.FileStream,它提供对 path 中指定的文件的读/写访问。
//
// 异常:
// T:System.UnauthorizedAccessException:
// 调用方没有所要求的权限。- 或 - path 指定了一个只读文件。
//
// T:System.ArgumentException:
// path 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// T:System.ArgumentNullException:
// path 为 null。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路径无效(例如,它位于未映射的驱动器上)。
//
// T:System.IO.IOException:
// 创建文件时发生 I/O 错误。
//
// T:System.NotSupportedException:
// path 的格式无效。
public static FileStream Create(string path, int bufferSize);
//
// 摘要:
// 创建或覆盖指定的文件,指定缓冲区大小和一个描述如何创建或覆盖该文件的 System.IO.FileOptions 值。
//
// 参数:
// path:
// 文件的名称。
//
// bufferSize:
// 用于读取和写入到文件的已放入缓冲区的字节数。
//
// options:
// System.IO.FileOptions 值之一,它描述如何创建或覆盖该文件。
//
// 返回结果:
// 具有指定缓冲区大小的新文件。
//
// 异常:
// T:System.UnauthorizedAccessException:
// 调用方没有所要求的权限。- 或 - path 指定了一个只读文件。- 或 -为 options 指定了 System.IO.FileOptions.Encrypted,但当前平台不支持文件加密。
//
// T:System.UnauthorizedAccessException:
// 调用方没有所要求的权限。- 或 - path 指定了一个只读文件。
//
// T:System.UnauthorizedAccessException:
// 调用方没有所要求的权限。- 或 - path 指定了一个只读文件。
//
// T:System.ArgumentException:
// path 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// T:System.ArgumentNullException:
// path 为 null。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.IO.DirectoryNotFoundException:
// 指定路径无效(例如,它位于未映射的驱动器上)。
//
// T:System.IO.IOException:
// 创建文件时发生 I/O 错误。
//
// T:System.NotSupportedException:
// path 的格式无效。
public static FileStream Create(string path, int bufferSize, FileOptions options);
//
// 摘要:
// 创建或覆盖具有指定的缓冲区大小、文件选项和文件安全性的指定文件。
//
// 参数:
// path:
// 文件的名称。
//
// bufferSize:
// 用于读取和写入到文件的已放入缓冲区的字节数。
//
// options:
// System.IO.FileOptions 值之一,它描述如何创建或覆盖该文件。
//
// fileSecurity:
// System.Security.AccessControl.FileSecurity 值之一,它确定文件的访问控制和审核安全性。
//
// 返回结果:
// 具有指定的缓冲区大小、文件选项和文件安全性的新文件。
//
// 异常:
// T:System.UnauthorizedAccessException:
// 调用方没有所要求的权限。- 或 - path 指定了一个只读文件。- 或 -为 options 指定了 System.IO.FileOptions.Encrypted,但当前平台不支持文件加密。
//
// T:System.UnauthorizedAccessException:
// 调用方没有所要求的权限。- 或 - path 指定了一个只读文件。
//
// T:System.UnauthorizedAccessException:
// 调用方没有所要求的权限。- 或 - path 指定了一个只读文件。
//
// T:System.ArgumentException:
// path 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// T:System.ArgumentNullException:
// path 为 null。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路径无效(例如,它位于未映射的驱动器上)。
//
// T:System.IO.IOException:
// 创建文件时发生 I/O 错误。
//
// T:System.NotSupportedException:
// path 的格式无效。
public static FileStream Create(string path, int bufferSize, FileOptions options, FileSecurity fileSecurity);
//
// 摘要:
// 创建或打开用于写入 UTF-8 编码文本的文件。
//
// 参数:
// path:
// 要打开以进行写入的文件。
//
// 返回结果:
// 一个 System.IO.StreamWriter,它使用 UTF-8 编码写入到指定的文件。
//
// 异常:
// T:System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
//
// T:System.ArgumentException:
// path 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// T:System.ArgumentNullException:
// path 为 null。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路径无效(例如,它位于未映射的驱动器上)。
//
// T:System.NotSupportedException:
// path 的格式无效。
public static StreamWriter CreateText(string path);
//
// 摘要:
// 使用 System.IO.File.Encrypt(System.String) 方法解密由当前帐户加密的文件。
//
// 参数:
// path:
// 描述要解密的文件的路径。
//
// 异常:
// T:System.ArgumentException:
// path 参数为长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// T:System.ArgumentNullException:
// path 参数为 null。
//
// T:System.IO.DriveNotFoundException:
// 指定了无效的驱动器。
//
// T:System.IO.FileNotFoundException:
// 找不到 path 参数描述的文件。
//
// T:System.IO.IOException:
// 打开文件时发生 I/O 错误。 例如,加密文件已打开。- 或 -当前平台不支持此操作。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.PlatformNotSupportedException:
// 当前操作系统不是 Windows NT 或更高版本。
//
// T:System.NotSupportedException:
// 文件系统不是 NTFS。
//
// T:System.UnauthorizedAccessException:
// path 参数指定了一个只读文件。- 或 - 当前平台不支持此操作。- 或 - path 参数指定了一个目录。- 或 - 调用方没有所要求的权限。
[SecuritySafeCritical]
public static void Decrypt(string path);
//
// 摘要:
// 删除指定的文件。
//
// 参数:
// path:
// 要删除的文件的名称。 该指令不支持通配符。
//
// 异常:
// T:System.ArgumentException:
// path 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// T:System.ArgumentNullException:
// path 为 null。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路径无效(例如,它位于未映射的驱动器上)。
//
// T:System.IO.IOException:
// 指定的文件正在使用。- 或 -在文件中存在开放句柄,并且操作系统是 Windows XP 或更早的版本。 枚举目录和文件可能会导致此开放句柄出现。 有关详细信息,请参阅如何:枚举目录和文件。
//
// T:System.NotSupportedException:
// path 的格式无效。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.UnauthorizedAccessException:
// 调用方没有所要求的权限。- 或 - 该文件是正在使用的可执行文件。- 或 - path 是一个目录。- 或 - path 指定了一个只读文件。
[SecuritySafeCritical]
public static void Delete(string path);
//
// 摘要:
// 将某个文件加密,使得只有加密该文件的帐户才能将其解密。
//
// 参数:
// path:
// 描述要加密的文件的路径。
//
// 异常:
// T:System.ArgumentException:
// path 参数为长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// T:System.ArgumentNullException:
// path 参数为 null。
//
// T:System.IO.DriveNotFoundException:
// 指定了无效的驱动器。
//
// T:System.IO.FileNotFoundException:
// 找不到 path 参数描述的文件。
//
// T:System.IO.IOException:
// 打开文件时发生 I/O 错误。- 或 -当前平台不支持此操作。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.PlatformNotSupportedException:
// 当前操作系统不是 Windows NT 或更高版本。
//
// T:System.NotSupportedException:
// 文件系统不是 NTFS。
//
// T:System.UnauthorizedAccessException:
// path 参数指定了一个只读文件。- 或 - 当前平台不支持此操作。- 或 - path 参数指定了一个目录。- 或 - 调用方没有所要求的权限。
[SecuritySafeCritical]
public static void Encrypt(string path);
//
// 摘要:
// 确定指定的文件是否存在。
//
// 参数:
// path:
// 要检查的文件。
//
// 返回结果:
// 如果调用方具有要求的权限并且 true 包含现有文件的名称,则为 path;否则为 false。 如果 false 为 path(一个无效路径或零长度字符串),则此方法也将返回
// null。 如果调用方不具有读取指定文件所需的足够权限,则不引发异常并且该方法返回 false,这与 path 是否存在无关。
[SecuritySafeCritical]
public static bool Exists(string path);
//
// 摘要:
// 获取一个 System.Security.AccessControl.FileSecurity 对象,它封装指定文件的访问控制列表 (ACL) 条目。
//
// 参数:
// path:
// 一个文件的路径,该文件包含描述文件的访问控制列表 (ACL) 信息的 System.Security.AccessControl.FileSecurity
// 对象。
//
// 返回结果:
// 一个 System.Security.AccessControl.FileSecurity 对象,它封装由 path 参数描述的文件的访问控制规则。
//
// 异常:
// T:System.IO.IOException:
// 打开文件时发生 I/O 错误。
//
// T:System.Runtime.InteropServices.SEHException:
// path 参数为 null。
//
// T:System.SystemException:
// 找不到文件。
//
// T:System.UnauthorizedAccessException:
// path 参数指定了一个只读文件。- 或 - 当前平台不支持此操作。- 或 - path 参数指定了一个目录。- 或 - 调用方没有所要求的权限。
public static FileSecurity GetAccessControl(string path);
//
// 摘要:
// 获取一个 System.Security.AccessControl.FileSecurity 对象,封装特定文件的指定类型的访问控制列表 (ACL) 项。
//
// 参数:
// path:
// 一个文件的路径,该文件包含描述文件的访问控制列表 (ACL) 信息的 System.Security.AccessControl.FileSecurity
// 对象。
//
// includeSections:
// System.Security.AccessControl.AccessControlSections 值之一,它指定要接收的访问控制列表 (ACL) 信息的类型。
//
// 返回结果:
// 一个 System.Security.AccessControl.FileSecurity 对象,它封装由 path 参数描述的文件的访问控制规则。
//
// 异常:
// T:System.IO.IOException:
// 打开文件时发生 I/O 错误。
//
// T:System.Runtime.InteropServices.SEHException:
// path 参数为 null。
//
// T:System.SystemException:
// 找不到文件。
//
// T:System.UnauthorizedAccessException:
// path 参数指定了一个只读文件。- 或 - 当前平台不支持此操作。- 或 - path 参数指定了一个目录。- 或 - 调用方没有所要求的权限。
public static FileSecurity GetAccessControl(string path, AccessControlSections includeSections);
//
// 摘要:
// 获取在此路径上的文件的 System.IO.FileAttributes。
//
// 参数:
// path:
// 文件的路径。
//
// 返回结果:
// 路径上文件的 System.IO.FileAttributes。
//
// 异常:
// T:System.ArgumentException:
// path 为空,仅包含空格,或包含无效字符。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.NotSupportedException:
// path 的格式无效。
//
// T:System.IO.FileNotFoundException:
// path 表示一个文件且它是无效的,例如,位于未映射的驱动器上或找不到该文件。
//
// T:System.IO.DirectoryNotFoundException:
// path 表示一个目录且它是无效的,例如,位于未映射的驱动器上或找不到该目录。
//
// T:System.IO.IOException:
// 此文件正由另一个进程使用。
//
// T:System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
[SecuritySafeCritical]
public static FileAttributes GetAttributes(string path);
//
// 摘要:
// 返回指定文件或目录的创建日期和时间。
//
// 参数:
// path:
// 要获取其创建日期和时间信息的文件或目录。
//
// 返回结果:
// 一个 System.DateTime 结构,它被设置为指定文件或目录的创建日期和时间。 该值用本地时间表示。
//
// 异常:
// T:System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
//
// T:System.ArgumentException:
// path 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// T:System.ArgumentNullException:
// path 为 null。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.NotSupportedException:
// path 的格式无效。
[SecuritySafeCritical]
public static DateTime GetCreationTime(string path);
//
// 摘要:
// 返回指定的文件或目录的创建日期及时间,其格式为协调通用时 (UTC)。
//
// 参数:
// path:
// 要获取其创建日期和时间信息的文件或目录。
//
// 返回结果:
// 一个 System.DateTime 结构,它被设置为指定文件或目录的创建日期和时间。 该值用 UTC 时间表示。
//
// 异常:
// T:System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
//
// T:System.ArgumentException:
// path 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// T:System.ArgumentNullException:
// path 为 null。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.NotSupportedException:
// path 的格式无效。
[SecuritySafeCritical]
public static DateTime GetCreationTimeUtc(string path);
//
// 摘要:
// 返回上次访问指定文件或目录的日期和时间。
//
// 参数:
// path:
// 要获取其访问日期和时间信息的文件或目录。
//
// 返回结果:
// 一个 System.DateTime 结构,它被设置为上次访问指定文件或目录的日期和时间。 该值用本地时间表示。
//
// 异常:
// T:System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
//
// T:System.ArgumentException:
// path 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// T:System.ArgumentNullException:
// path 为 null。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.NotSupportedException:
// path 的格式无效。
[SecuritySafeCritical]
public static DateTime GetLastAccessTime(string path);
//
// 摘要:
// 返回上次访问指定的文件或目录的日期及时间,其格式为协调通用时 (UTC)。
//
// 参数:
// path:
// 要获取其访问日期和时间信息的文件或目录。
//
// 返回结果:
// 一个 System.DateTime 结构,它被设置为上次访问指定文件或目录的日期和时间。 该值用 UTC 时间表示。
//
// 异常:
// T:System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
//
// T:System.ArgumentException:
// path 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// T:System.ArgumentNullException:
// path 为 null。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.NotSupportedException:
// path 的格式无效。
[SecuritySafeCritical]
public static DateTime GetLastAccessTimeUtc(string path);
//
// 摘要:
// 返回上次写入指定文件或目录的日期和时间。
//
// 参数:
// path:
// 要获取其写入日期和时间信息的文件或目录。
//
// 返回结果:
// 一个 System.DateTime 结构,它被设置为上次写入指定文件或目录的日期和时间。 该值用本地时间表示。
//
// 异常:
// T:System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
//
// T:System.ArgumentException:
// path 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// T:System.ArgumentNullException:
// path 为 null。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.NotSupportedException:
// path 的格式无效。
[SecuritySafeCritical]
public static DateTime GetLastWriteTime(string path);
//
// 摘要:
// 返回上次写入指定的文件或目录的日期和时间,其格式为协调通用时 (UTC)。
//
// 参数:
// path:
// 要获取其写入日期和时间信息的文件或目录。
//
// 返回结果:
// 一个 System.DateTime 结构,它被设置为上次写入指定文件或目录的日期和时间。 该值用 UTC 时间表示。
//
// 异常:
// T:System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
//
// T:System.ArgumentException:
// path 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// T:System.ArgumentNullException:
// path 为 null。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.NotSupportedException:
// path 的格式无效。
[SecuritySafeCritical]
public static DateTime GetLastWriteTimeUtc(string path);
//
// 摘要:
// 将指定文件移到新位置,提供要指定新文件名的选项。
//
// 参数:
// sourceFileName:
// 要移动的文件的名称。 可以包括相对或绝对路径。
//
// destFileName:
// 文件的新路径和名称。
//
// 异常:
// T:System.IO.IOException:
// 目标文件已存在。- 或 -未找到 sourceFileName。
//
// T:System.ArgumentNullException:
// sourceFileName 或 destFileName 为 null。
//
// T:System.ArgumentException:
// sourceFileName 或 destFileName 为长度为零的字符串,仅包含空格,或包含在 System.IO.Path.InvalidPathChars
// 中定义无效字符。
//
// T:System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.IO.DirectoryNotFoundException:
// sourceFileName 或 destFileName 中指定的路径无效(例如,它位于未映射的驱动器上)。
//
// T:System.NotSupportedException:
// sourceFileName 或 destFileName 的格式无效。
[SecuritySafeCritical]
public static void Move(string sourceFileName, string destFileName);
//
// 摘要:
// 打开指定路径上的 System.IO.FileStream,具有带读、写或读/写访问的指定模式和指定的共享选项。
//
// 参数:
// path:
// 要打开的文件。
//
// mode:
// System.IO.FileMode 值,用于指定在文件不存在时是否创建该文件,并确定是保留还是覆盖现有文件的内容。
//
// access:
// 一个 System.IO.FileAccess 值,它指定可以对文件执行的操作。
//
// share:
// 一个 System.IO.FileShare 值,它指定其他线程所具有的对该文件的访问类型。
//
// 返回结果:
// 指定路径上的 System.IO.FileStream,具有带读、写或读/写访问的指定模式以及指定的共享选项。
//
// 异常:
// T:System.ArgumentException:
// path 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。- 或
// - access 指定了 Read,并且 mode 指定了 Create、CreateNew、Truncate 或 Append。
//
// T:System.ArgumentNullException:
// path 为 null。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路径无效(例如,它位于未映射的驱动器上)。
//
// T:System.IO.IOException:
// 打开文件时发生 I/O 错误。
//
// T:System.UnauthorizedAccessException:
// path 指定了一个只读文件,并且 access 不是 Read。- 或 - path 指定了一个目录。- 或 - 调用方没有所要求的权限。- 或 -mode
// 为 System.IO.FileMode.Create,且指定的文件是一个隐藏文件。
//
// T:System.ArgumentOutOfRangeException:
// mode、access 或 share 指定了一个无效值。
//
// T:System.IO.FileNotFoundException:
// 未找到 path 中指定的文件。
//
// T:System.NotSupportedException:
// path 的格式无效。
public static FileStream Open(string path, FileMode mode, FileAccess access, FileShare share);
//
// 摘要:
// 以读/写访问权限打开指定路径上的 System.IO.FileStream。
//
// 参数:
// path:
// 要打开的文件。
//
// mode:
// System.IO.FileMode 值,用于指定在文件不存在时是否创建该文件,并确定是保留还是覆盖现有文件的内容。
//
// 返回结果:
// 以读/写访问与不共享权限打开的指定模式和路径上的 System.IO.FileStream。
//
// 异常:
// T:System.ArgumentException:
// path 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// T:System.ArgumentNullException:
// path 为 null。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路径无效(例如,它位于未映射的驱动器上)。
//
// T:System.IO.IOException:
// 打开文件时发生 I/O 错误。
//
// T:System.UnauthorizedAccessException:
// path 指定了一个只读文件。- 或 - 当前平台不支持此操作。- 或 - path 指定了一个目录。- 或 - 调用方没有所要求的权限。- 或 -mode
// 为 System.IO.FileMode.Create,且指定的文件是一个隐藏文件。
//
// T:System.ArgumentOutOfRangeException:
// mode 指定了一个无效值。
//
// T:System.IO.FileNotFoundException:
// 未找到 path 中指定的文件。
//
// T:System.NotSupportedException:
// path 的格式无效。
public static FileStream Open(string path, FileMode mode);
//
// 摘要:
// 以指定的模式和访问权限打开指定路径上的 System.IO.FileStream。
//
// 参数:
// path:
// 要打开的文件。
//
// mode:
// System.IO.FileMode 值,用于指定在文件不存在时是否创建该文件,并确定是保留还是覆盖现有文件的内容。
//
// access:
// 一个 System.IO.FileAccess 值,它指定可以对文件执行的操作。
//
// 返回结果:
// 一个非共享的 System.IO.FileStream,它提供对指定文件的访问,并且具有指定的模式和访问权限。
//
// 异常:
// T:System.ArgumentException:
// path 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。- 或
// - access 指定了 Read,并且 mode 指定了 Create、CreateNew、Truncate 或 Append。
//
// T:System.ArgumentNullException:
// path 为 null。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路径无效(例如,它位于未映射的驱动器上)。
//
// T:System.IO.IOException:
// 打开文件时发生 I/O 错误。
//
// T:System.UnauthorizedAccessException:
// path 指定了一个只读文件,并且 access 不是 Read。- 或 - path 指定了一个目录。- 或 - 调用方没有所要求的权限。- 或 -mode
// 为 System.IO.FileMode.Create,且指定的文件是一个隐藏文件。
//
// T:System.ArgumentOutOfRangeException:
// mode 或 access 指定了一个无效值。
//
// T:System.IO.FileNotFoundException:
// 未找到 path 中指定的文件。
//
// T:System.NotSupportedException:
// path 的格式无效。
public static FileStream Open(string path, FileMode mode, FileAccess access);
//
// 摘要:
// 打开现有文件以进行读取。
//
// 参数:
// path:
// 要打开以进行读取的文件。
//
// 返回结果:
// 指定路径上的只读 System.IO.FileStream。
//
// 异常:
// T:System.ArgumentException:
// path 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// T:System.ArgumentNullException:
// path 为 null。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路径无效(例如,它位于未映射的驱动器上)。
//
// T:System.UnauthorizedAccessException:
// path 指定了一个目录。- 或 - 调用方没有所要求的权限。
//
// T:System.IO.FileNotFoundException:
// 未找到 path 中指定的文件。
//
// T:System.NotSupportedException:
// path 的格式无效。
//
// T:System.IO.IOException:
// 打开文件时发生 I/O 错误。
public static FileStream OpenRead(string path);
//
// 摘要:
// 打开现有 UTF-8 编码文本文件以进行读取。
//
// 参数:
// path:
// 要打开以进行读取的文件。
//
// 返回结果:
// 指定路径上的 System.IO.StreamReader。
//
// 异常:
// T:System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
//
// T:System.ArgumentException:
// path 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// T:System.ArgumentNullException:
// path 为 null。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路径无效(例如,它位于未映射的驱动器上)。
//
// T:System.IO.FileNotFoundException:
// 未找到 path 中指定的文件。
//
// T:System.NotSupportedException:
// path 的格式无效。
public static StreamReader OpenText(string path);
//
// 摘要:
// 打开一个现有文件或创建一个新文件以进行写入。
//
// 参数:
// path:
// 要打开以进行写入的文件。
//
// 返回结果:
// 指定路径上具有 System.IO.FileStream 访问权限的非共享的 System.IO.FileAccess.Write 对象。
//
// 异常:
// T:System.UnauthorizedAccessException:
// 调用方没有所要求的权限。- 或 - path 指定一个只读文件或目录。
//
// T:System.ArgumentException:
// path 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// T:System.ArgumentNullException:
// path 为 null。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路径无效(例如,它位于未映射的驱动器上)。
//
// T:System.NotSupportedException:
// path 的格式无效。
public static FileStream OpenWrite(string path);
//
// 摘要:
// 打开一个二进制文件,将文件的内容读入一个字节数组,然后关闭该文件。
//
// 参数:
// path:
// 要打开以进行读取的文件。
//
// 返回结果:
// 包含文件内容的字节数组。
//
// 异常:
// T:System.ArgumentException:
// path 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// T:System.ArgumentNullException:
// path 为 null。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路径无效(例如,它位于未映射的驱动器上)。
//
// T:System.IO.IOException:
// 打开文件时发生 I/O 错误。
//
// T:System.UnauthorizedAccessException:
// 当前平台不支持此操作。- 或 - path 指定了一个目录。- 或 - 调用方没有所要求的权限。
//
// T:System.IO.FileNotFoundException:
// 未找到 path 中指定的文件。
//
// T:System.NotSupportedException:
// path 的格式无效。
//
// T:System.Security.SecurityException:
// 调用方没有所要求的权限。
[SecuritySafeCritical]
public static byte[] ReadAllBytes(string path);
//
// 摘要:
// 打开一个文件,使用指定的编码读取文件的所有行,然后关闭该文件。
//
// 参数:
// path:
// 要打开以进行读取的文件。
//
// encoding:
// 应用到文件内容的编码。
//
// 返回结果:
// 包含文件所有行的字符串数组。
//
// 异常:
// T:System.ArgumentException:
// path 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// T:System.ArgumentNullException:
// path 为 null。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路径无效(例如,它位于未映射的驱动器上)。
//
// T:System.IO.IOException:
// 打开文件时发生 I/O 错误。
//
// T:System.UnauthorizedAccessException:
// path 指定了一个只读文件。- 或 - 当前平台不支持此操作。- 或 - path 指定了一个目录。- 或 - 调用方没有所要求的权限。
//
// T:System.IO.FileNotFoundException:
// 未找到 path 中指定的文件。
//
// T:System.NotSupportedException:
// path 的格式无效。
//
// T:System.Security.SecurityException:
// 调用方没有所要求的权限。
public static string[] ReadAllLines(string path, Encoding encoding);
//
// 摘要:
// 打开一个文本文件,读取文件的所有行,然后关闭该文件。
//
// 参数:
// path:
// 要打开以进行读取的文件。
//
// 返回结果:
// 包含文件所有行的字符串数组。
//
// 异常:
// T:System.ArgumentException:
// path 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// T:System.ArgumentNullException:
// path 为 null。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路径无效(例如,它位于未映射的驱动器上)。
//
// T:System.IO.IOException:
// 打开文件时发生 I/O 错误。
//
// T:System.UnauthorizedAccessException:
// path 指定了一个只读文件。- 或 - 当前平台不支持此操作。- 或 - path 指定了一个目录。- 或 - 调用方没有所要求的权限。
//
// T:System.IO.FileNotFoundException:
// 未找到 path 中指定的文件。
//
// T:System.NotSupportedException:
// path 的格式无效。
//
// T:System.Security.SecurityException:
// 调用方没有所要求的权限。
public static string[] ReadAllLines(string path);
//
// 摘要:
// 打开一个文本文件,读取文件的所有行,然后关闭该文件。
//
// 参数:
// path:
// 要打开以进行读取的文件。
//
// 返回结果:
// 包含文件所有行的字符串。
//
// 异常:
// T:System.ArgumentException:
// path 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// T:System.ArgumentNullException:
// path 为 null。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路径无效(例如,它位于未映射的驱动器上)。
//
// T:System.IO.IOException:
// 打开文件时发生 I/O 错误。
//
// T:System.UnauthorizedAccessException:
// path 指定了一个只读文件。- 或 - 当前平台不支持此操作。- 或 - path 指定了一个目录。- 或 - 调用方没有所要求的权限。
//
// T:System.IO.FileNotFoundException:
// 未找到 path 中指定的文件。
//
// T:System.NotSupportedException:
// path 的格式无效。
//
// T:System.Security.SecurityException:
// 调用方没有所要求的权限。
[SecuritySafeCritical]
public static string ReadAllText(string path);
//
// 摘要:
// 打开一个文件,使用指定的编码读取文件的所有行,然后关闭该文件。
//
// 参数:
// path:
// 要打开以进行读取的文件。
//
// encoding:
// 应用到文件内容的编码。
//
// 返回结果:
// 包含文件所有行的字符串。
//
// 异常:
// T:System.ArgumentException:
// path 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// T:System.ArgumentNullException:
// path 为 null。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路径无效(例如,它位于未映射的驱动器上)。
//
// T:System.IO.IOException:
// 打开文件时发生 I/O 错误。
//
// T:System.UnauthorizedAccessException:
// path 指定了一个只读文件。- 或 - 当前平台不支持此操作。- 或 - path 指定了一个目录。- 或 - 调用方没有所要求的权限。
//
// T:System.IO.FileNotFoundException:
// 未找到 path 中指定的文件。
//
// T:System.NotSupportedException:
// path 的格式无效。
//
// T:System.Security.SecurityException:
// 调用方没有所要求的权限。
[SecuritySafeCritical]
public static string ReadAllText(string path, Encoding encoding);
//
// 摘要:
// 读取文件的行。
//
// 参数:
// path:
// 要读取的文件。
//
// 返回结果:
// 该文件的所有行或查询结果所示的行。
//
// 异常:
// T:System.ArgumentException:
// path 为长度为零的字符串,仅包含空白,或包含 System.IO.Path.GetInvalidPathChars 方法定义的一个或多个无效字符。
//
// T:System.ArgumentNullException:
// path 为 null。
//
// T:System.IO.DirectoryNotFoundException:
// path 无效(例如,它在未映射的驱动器上)。
//
// T:System.IO.FileNotFoundException:
// 未找到 path 指定的文件。
//
// T:System.IO.IOException:
// 打开文件时发生 I/O 错误。
//
// T:System.IO.PathTooLongException:
// path 超出系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.Security.SecurityException:
// 调用方没有所要求的权限。
//
// T:System.UnauthorizedAccessException:
// path 指定只读文件。- 或 -当前平台不支持此操作。- 或 -path 是一个目录。- 或 -调用方没有所要求的权限。
public static IEnumerable<string> ReadLines(string path);
//
// 摘要:
// 读取具有指定编码的文件的行。
//
// 参数:
// path:
// 要读取的文件。
//
// encoding:
// 应用到文件内容的编码。
//
// 返回结果:
// 该文件的所有行或查询结果所示的行。
//
// 异常:
// T:System.ArgumentException:
// path 为长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.GetInvalidPathChars 定义的无效字符。
//
// T:System.ArgumentNullException:
// path 为 null。
//
// T:System.IO.DirectoryNotFoundException:
// path 无效(例如,它在未映射的驱动器上)。
//
// T:System.IO.FileNotFoundException:
// 未找到 path 指定的文件。
//
// T:System.IO.IOException:
// 打开文件时发生 I/O 错误。
//
// T:System.IO.PathTooLongException:
// path 超出系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.Security.SecurityException:
// 调用方没有所要求的权限。
//
// T:System.UnauthorizedAccessException:
// path 指定只读文件。- 或 -当前平台不支持此操作。- 或 -path 是一个目录。- 或 -调用方没有所要求的权限。
public static IEnumerable<string> ReadLines(string path, Encoding encoding);
//
// 摘要:
// 使用其他文件的内容替换指定文件的内容,这一过程将删除原始文件,并创建被替换文件的备份。
//
// 参数:
// sourceFileName:
// 替换由 destinationFileName 指定的文件的文件名。
//
// destinationFileName:
// 被替换文件的名称。
//
// destinationBackupFileName:
// 备份文件的名称。
//
// 异常:
// T:System.ArgumentException:
// destinationFileName 参数描述的路径格式不合法。- 或 -destinationBackupFileName 参数描述的路径格式不合法。
//
// T:System.ArgumentNullException:
// destinationFileName 参数为 null。
//
// T:System.IO.DriveNotFoundException:
// 指定了无效的驱动器。
//
// T:System.IO.FileNotFoundException:
// 找不到当前 System.IO.FileInfo 对象描述的文件。- 或 -找不到 destinationBackupFileName 参数描述的文件。
//
// T:System.IO.IOException:
// 打开文件时发生 I/O 错误。- 或 -sourceFileName 和 destinationFileName 参数指定相同的文件。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.PlatformNotSupportedException:
// 操作系统是 Windows 98 Second Edition 或更早版本,且文件系统不是 NTFS。
//
// T:System.UnauthorizedAccessException:
// sourceFileName 或 destinationFileName 参数指定了一个只读文件。- 或 - 当前平台不支持此操作。- 或 - 源参数或目标参数指定的是目录,而不是文件。-
// 或 - 调用方没有所要求的权限。
public static void Replace(string sourceFileName, string destinationFileName, string destinationBackupFileName);
//
// 摘要:
// 用其他文件的内容替换指定文件的内容,这一过程将删除原始文件,并创建被替换文件的备份,还可以忽略合并错误。
//
// 参数:
// sourceFileName:
// 替换由 destinationFileName 指定的文件的文件名。
//
// destinationFileName:
// 被替换文件的名称。
//
// destinationBackupFileName:
// 备份文件的名称。
//
// ignoreMetadataErrors:
// 如果忽略从被替换文件到替换文件的合并错误(如特性和访问控制列表 (ACL)),则为 true,否则为 false。
//
// 异常:
// T:System.ArgumentException:
// destinationFileName 参数描述的路径格式不合法。- 或 -destinationBackupFileName 参数描述的路径格式不合法。
//
// T:System.ArgumentNullException:
// destinationFileName 参数为 null。
//
// T:System.IO.DriveNotFoundException:
// 指定了无效的驱动器。
//
// T:System.IO.FileNotFoundException:
// 找不到当前 System.IO.FileInfo 对象描述的文件。- 或 -找不到 destinationBackupFileName 参数描述的文件。
//
// T:System.IO.IOException:
// 打开文件时发生 I/O 错误。- 或 -sourceFileName 和 destinationFileName 参数指定相同的文件。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.PlatformNotSupportedException:
// 操作系统是 Windows 98 Second Edition 或更早版本,且文件系统不是 NTFS。
//
// T:System.UnauthorizedAccessException:
// sourceFileName 或 destinationFileName 参数指定了一个只读文件。- 或 - 当前平台不支持此操作。- 或 - 源参数或目标参数指定的是目录,而不是文件。-
// 或 - 调用方没有所要求的权限。
public static void Replace(string sourceFileName, string destinationFileName, string destinationBackupFileName, bool ignoreMetadataErrors);
//
// 摘要:
// 将 System.Security.AccessControl.FileSecurity 对象描述的访问控制列表 (ACL) 项应用于指定的文件。
//
// 参数:
// path:
// 从其中添加或移除访问控制列表 (ACL) 项的文件。
//
// fileSecurity:
// 一个 System.Security.AccessControl.FileSecurity 对象,描述要应用于 path 参数所描述的文件的 ACL 项。
//
// 异常:
// T:System.IO.IOException:
// 打开文件时发生 I/O 错误。
//
// T:System.Runtime.InteropServices.SEHException:
// path 参数为 null。
//
// T:System.SystemException:
// 找不到文件。
//
// T:System.UnauthorizedAccessException:
// path 参数指定了一个只读文件。- 或 - 当前平台不支持此操作。- 或 - path 参数指定了一个目录。- 或 - 调用方没有所要求的权限。
//
// T:System.ArgumentNullException:
// fileSecurity 参数为 null。
[SecuritySafeCritical]
public static void SetAccessControl(string path, FileSecurity fileSecurity);
//
// 摘要:
// 获取指定路径上的文件的指定 System.IO.FileAttributes。
//
// 参数:
// path:
// 文件的路径。
//
// fileAttributes:
// 枚举值的按位组合。
//
// 异常:
// T:System.ArgumentException:
// path 为空,只包含空格,包含无效字符或文件属性无效。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.NotSupportedException:
// path 的格式无效。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路径无效(例如,它位于未映射的驱动器上)。
//
// T:System.IO.FileNotFoundException:
// 无法找到该文件。
//
// T:System.UnauthorizedAccessException:
// path 指定了一个只读文件。- 或 - 当前平台不支持此操作。- 或 - path 指定了一个目录。- 或 - 调用方没有所要求的权限。
[SecuritySafeCritical]
public static void SetAttributes(string path, FileAttributes fileAttributes);
//
// 摘要:
// 设置创建该文件的日期和时间。
//
// 参数:
// path:
// 要设置其创建日期和时间信息的文件。
//
// creationTime:
// 一个 System.DateTime,它包含要为 path 的创建日期和时间设置的值。 该值用本地时间表示。
//
// 异常:
// T:System.IO.FileNotFoundException:
// 未找到指定路径。
//
// T:System.ArgumentException:
// path 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// T:System.ArgumentNullException:
// path 为 null。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.IO.IOException:
// 执行操作时发生 I/O 错误。
//
// T:System.ArgumentOutOfRangeException:
// creationTime 指定的值超出了该操作所允许的日期范围和/或时间范围。
//
// T:System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
//
// T:System.NotSupportedException:
// path 的格式无效。
public static void SetCreationTime(string path, DateTime creationTime);
//
// 摘要:
// 设置文件创建的日期和时间,其格式为协调通用时 (UTC)。
//
// 参数:
// path:
// 要设置其创建日期和时间信息的文件。
//
// creationTimeUtc:
// 一个 System.DateTime,它包含要为 path 的创建日期和时间设置的值。 该值用 UTC 时间表示。
//
// 异常:
// T:System.IO.FileNotFoundException:
// 未找到指定路径。
//
// T:System.ArgumentException:
// path 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// T:System.ArgumentNullException:
// path 为 null。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.IO.IOException:
// 执行操作时发生 I/O 错误。
//
// T:System.ArgumentOutOfRangeException:
// creationTime 指定的值超出了该操作所允许的日期范围和/或时间范围。
//
// T:System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
//
// T:System.NotSupportedException:
// path 的格式无效。
[SecuritySafeCritical]
public static void SetCreationTimeUtc(string path, DateTime creationTimeUtc);
//
// 摘要:
// 设置上次访问指定文件的日期和时间。
//
// 参数:
// path:
// 要设置其访问日期和时间信息的文件。
//
// lastAccessTime:
// 一个 System.DateTime,它包含要为 path 的上次访问日期和时间设置的值。 该值用本地时间表示。
//
// 异常:
// T:System.ArgumentException:
// path 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// T:System.ArgumentNullException:
// path 为 null。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.IO.FileNotFoundException:
// 未找到指定路径。
//
// T:System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
//
// T:System.NotSupportedException:
// path 的格式无效。
//
// T:System.ArgumentOutOfRangeException:
// lastAccessTime 指定的值超出了该操作所允许的日期或时间范围。
public static void SetLastAccessTime(string path, DateTime lastAccessTime);
//
// 摘要:
// 设置上次访问指定的文件的日期和时间,其格式为协调通用时 (UTC)。
//
// 参数:
// path:
// 要设置其访问日期和时间信息的文件。
//
// lastAccessTimeUtc:
// 一个 System.DateTime,它包含要为 path 的上次访问日期和时间设置的值。 该值用 UTC 时间表示。
//
// 异常:
// T:System.ArgumentException:
// path 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// T:System.ArgumentNullException:
// path 为 null。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.IO.FileNotFoundException:
// 未找到指定路径。
//
// T:System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
//
// T:System.NotSupportedException:
// path 的格式无效。
//
// T:System.ArgumentOutOfRangeException:
// lastAccessTimeUtc 指定的值超出了该操作所允许的日期或时间范围。
[SecuritySafeCritical]
public static void SetLastAccessTimeUtc(string path, DateTime lastAccessTimeUtc);
//
// 摘要:
// 设置上次写入指定文件的日期和时间。
//
// 参数:
// path:
// 要设置其日期和时间信息的文件。
//
// lastWriteTime:
// 一个 System.DateTime,它包含要为 path 的上次写入日期和时间设置的值。 该值用本地时间表示。
//
// 异常:
// T:System.ArgumentException:
// path 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// T:System.ArgumentNullException:
// path 为 null。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.IO.FileNotFoundException:
// 未找到指定路径。
//
// T:System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
//
// T:System.NotSupportedException:
// path 的格式无效。
//
// T:System.ArgumentOutOfRangeException:
// lastWriteTime 指定的值超出了该操作所允许的日期或时间范围。
public static void SetLastWriteTime(string path, DateTime lastWriteTime);
//
// 摘要:
// 设置上次写入指定的文件的日期和时间,其格式为协调通用时 (UTC)。
//
// 参数:
// path:
// 要设置其日期和时间信息的文件。
//
// lastWriteTimeUtc:
// 一个 System.DateTime,它包含要为 path 的上次写入日期和时间设置的值。 该值用 UTC 时间表示。
//
// 异常:
// T:System.ArgumentException:
// path 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// T:System.ArgumentNullException:
// path 为 null。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.IO.FileNotFoundException:
// 未找到指定路径。
//
// T:System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
//
// T:System.NotSupportedException:
// path 的格式无效。
//
// T:System.ArgumentOutOfRangeException:
// lastWriteTimeUtc 指定的值超出了该操作所允许的日期或时间范围。
[SecuritySafeCritical]
public static void SetLastWriteTimeUtc(string path, DateTime lastWriteTimeUtc);
//
// 摘要:
// 创建一个新文件,在其中写入指定的字节数组,然后关闭该文件。 如果目标文件已存在,则覆盖该文件。
//
// 参数:
// path:
// 要写入的文件。
//
// bytes:
// 要写入文件的字节。
//
// 异常:
// T:System.ArgumentException:
// path 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// T:System.ArgumentNullException:
// path 为 null 或字节数组为空。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路径无效(例如,它位于未映射的驱动器上)。
//
// T:System.IO.IOException:
// 打开文件时发生 I/O 错误。
//
// T:System.UnauthorizedAccessException:
// path 指定了一个只读文件。- 或 - 当前平台不支持此操作。- 或 - path 指定了一个目录。- 或 - 调用方没有所要求的权限。
//
// T:System.NotSupportedException:
// path 的格式无效。
//
// T:System.Security.SecurityException:
// 调用方没有所要求的权限。
[SecuritySafeCritical]
public static void WriteAllBytes(string path, byte[] bytes);
//
// 摘要:
// 创建一个新文件,在其中写入指定的字节数组,然后关闭该文件。
//
// 参数:
// path:
// 要写入的文件。
//
// contents:
// 要写入文件的字符串数组。
//
// 异常:
// T:System.ArgumentException:
// path 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// T:System.ArgumentNullException:
// path 或 contents 为 null。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路径无效(例如,它位于未映射的驱动器上)。
//
// T:System.IO.IOException:
// 打开文件时发生 I/O 错误。
//
// T:System.UnauthorizedAccessException:
// path 指定了一个只读文件。- 或 - 当前平台不支持此操作。- 或 - path 指定了一个目录。- 或 - 调用方没有所要求的权限。
//
// T:System.NotSupportedException:
// path 的格式无效。
//
// T:System.Security.SecurityException:
// 调用方没有所要求的权限。
public static void WriteAllLines(string path, string[] contents);
//
// 摘要:
// 创建一个新文件,使用指定编码在其中写入指定的字符串数组,然后关闭该文件。
//
// 参数:
// path:
// 要写入的文件。
//
// contents:
// 要写入文件的字符串数组。
//
// encoding:
// 一个 System.Text.Encoding 对象,它表示应用于字符串数组的字符编码。
//
// 异常:
// T:System.ArgumentException:
// path 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// T:System.ArgumentNullException:
// path 或 contents 为 null。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路径无效(例如,它位于未映射的驱动器上)。
//
// T:System.IO.IOException:
// 打开文件时发生 I/O 错误。
//
// T:System.UnauthorizedAccessException:
// path 指定了一个只读文件。- 或 - 当前平台不支持此操作。- 或 - path 指定了一个目录。- 或 - 调用方没有所要求的权限。
//
// T:System.NotSupportedException:
// path 的格式无效。
//
// T:System.Security.SecurityException:
// 调用方没有所要求的权限。
public static void WriteAllLines(string path, string[] contents, Encoding encoding);
//
// 摘要:
// 创建一个新文件,向其中写入一个字符串集合,然后关闭该文件。
//
// 参数:
// path:
// 要写入的文件。
//
// contents:
// 要写入到文件中的行。
//
// 异常:
// T:System.ArgumentException:
// path 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.GetInvalidPathChars 方法定义的无效字符。
//
// T:System.ArgumentNullException:
// path 或 contents 是 null。
//
// T:System.IO.DirectoryNotFoundException:
// path 无效(例如,它位于未映射的驱动器上)。
//
// T:System.IO.IOException:
// 打开文件时发生 I/O 错误。
//
// T:System.IO.PathTooLongException:
// path 超出系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.NotSupportedException:
// path 的格式无效。
//
// T:System.Security.SecurityException:
// 调用方没有所要求的权限。
//
// T:System.UnauthorizedAccessException:
// path 指定只读文件。- 或 -当前平台不支持此操作。- 或 -path 是一个目录。- 或 -调用方没有所要求的权限。
public static void WriteAllLines(string path, IEnumerable<string> contents);
//
// 摘要:
// 使用指定的编码创建一个新文件,向其中写入一个字符串集合,然后关闭该文件。
//
// 参数:
// path:
// 要写入的文件。
//
// contents:
// 要写入到文件中的行。
//
// encoding:
// 要使用的字符编码。
//
// 异常:
// T:System.ArgumentException:
// path 为长度为零的字符串,仅包含空白,或包含 System.IO.Path.GetInvalidPathChars 方法定义的一个或多个无效字符。
//
// T:System.ArgumentNullException:
// path contents 或 encoding 为 null。
//
// T:System.IO.DirectoryNotFoundException:
// path 无效(例如,它在未映射的驱动器上)。
//
// T:System.IO.IOException:
// 打开文件时发生 I/O 错误。
//
// T:System.IO.PathTooLongException:
// path 超出系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.NotSupportedException:
// path 的格式无效。
//
// T:System.Security.SecurityException:
// 调用方没有所要求的权限。
//
// T:System.UnauthorizedAccessException:
// path 指定只读文件。- 或 -当前平台不支持此操作。- 或 -path 是一个目录。- 或 -调用方没有所要求的权限。
public static void WriteAllLines(string path, IEnumerable<string> contents, Encoding encoding);
//
// 摘要:
// 创建一个新文件,向其中写入指定的字符串,然后关闭文件。 如果目标文件已存在,则覆盖该文件。
//
// 参数:
// path:
// 要写入的文件。
//
// contents:
// 要写入文件的字符串。
//
// 异常:
// T:System.ArgumentException:
// path 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// T:System.ArgumentNullException:
// path 为 null 或 contents 为空。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路径无效(例如,它位于未映射的驱动器上)。
//
// T:System.IO.IOException:
// 打开文件时发生 I/O 错误。
//
// T:System.UnauthorizedAccessException:
// path 指定了一个只读文件。- 或 - 当前平台不支持此操作。- 或 - path 指定了一个目录。- 或 - 调用方没有所要求的权限。
//
// T:System.NotSupportedException:
// path 的格式无效。
//
// T:System.Security.SecurityException:
// 调用方没有所要求的权限。
[SecuritySafeCritical]
public static void WriteAllText(string path, string contents);
//
// 摘要:
// 创建一个新文件,使用指定编码向其中写入指定的字符串,然后关闭文件。 如果目标文件已存在,则覆盖该文件。
//
// 参数:
// path:
// 要写入的文件。
//
// contents:
// 要写入文件的字符串。
//
// encoding:
// 应用于字符串的编码。
//
// 异常:
// T:System.ArgumentException:
// path 是一个长度为零的字符串,仅包含空格,或包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// T:System.ArgumentNullException:
// path 为 null 或 contents 为空。
//
// T:System.IO.PathTooLongException:
// 指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路径无效(例如,它位于未映射的驱动器上)。
//
// T:System.IO.IOException:
// 打开文件时发生 I/O 错误。
//
// T:System.UnauthorizedAccessException:
// path 指定了一个只读文件。- 或 - 当前平台不支持此操作。- 或 - path 指定了一个目录。- 或 - 调用方没有所要求的权限。
//
// T:System.NotSupportedException:
// path 的格式无效。
//
// T:System.Security.SecurityException:
// 调用方没有所要求的权限。
[SecuritySafeCritical]
public static void WriteAllText(string path, string contents, Encoding encoding);
}
}