码迷,mamicode.com
首页 > Windows程序 > 详细

C#快速读写文件

时间:2017-10-19 21:05:05      阅读:295      评论:0      收藏:0      [点我收藏+]

标签:ted   多个   inter   authorize   write   技术   decrypt   trunc   ext   

技术分享
using System;
using System.Runtime.InteropServices;
using System.Security.AccessControl;
using System.Text;

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

C#快速读写文件

标签:ted   多个   inter   authorize   write   技术   decrypt   trunc   ext   

原文地址:http://www.cnblogs.com/zhanglixina/p/7694778.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!