码迷,mamicode.com
首页 > 其他好文 > 详细

文件IO

时间:2016-07-13 19:38:24      阅读:170      评论:0      收藏:0      [点我收藏+]

标签:

#region 程序集 mscorlib.dll, v4.0.0.0
// C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.0\mscorlib.dll
#endregion

using System;
using System.Collections.Generic;
using System.Runtime.InteropServices;
using System.Security;
using System.Security.AccessControl;

namespace System.IO
{
// 摘要:
// 公开用于创建、移动和枚举通过目录和子目录的静态方法。此类不能被继承。
[ComVisible(true)]
public static class Directory
{
// 摘要:
// 按 path 的指定创建所有目录和子目录。
//
// 参数:
// path:
// 要创建的目录路径。
//
// 返回结果:
// 由 path 指定的 System.IO.DirectoryInfo。
//
// 异常:
// System.IO.IOException:
// path 指定的目录是只读的。
//
// System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
//
// System.ArgumentException:
// path 是一个零长度字符串,仅包含空白或者包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。-
// 或 -path 带有前缀,或仅包含一个冒号字符 (:)。
//
// System.ArgumentNullException:
// path 为 null。
//
// System.IO.PathTooLongException:
// 指定的路径、文件名或者两者都超出了系统定义的最大长度。例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260
// 个字符。
//
// System.IO.DirectoryNotFoundException:
// 指定的路径无效(例如,它位于未映射的驱动器上)。
//
// System.NotSupportedException:
// path 包含一个冒号字符 (:),该冒号字符不是驱动器标签(“C:\”)的一部分。
[SecuritySafeCritical]
public static DirectoryInfo CreateDirectory(string path);
//
// 摘要:
// 创建指定路径中的所有目录,并应用指定的 Windows 安全性。
//
// 参数:
// path:
// 要创建的目录。
//
// directorySecurity:
// 要应用于此目录的访问控制。
//
// 返回结果:
// 表示新创建的目录的 System.IO.DirectoryInfo 对象。
//
// 异常:
// System.IO.IOException:
// path 指定的目录是只读的。
//
// System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
//
// System.ArgumentException:
// path 是一个零长度字符串,仅包含空白或者包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。-
// 或 -path 带有前缀,或仅包含一个冒号字符 (:)。
//
// System.ArgumentNullException:
// path 为 null。
//
// System.IO.PathTooLongException:
// 指定的路径、文件名或者两者都超出了系统定义的最大长度。例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260
// 个字符。
//
// System.IO.DirectoryNotFoundException:
// 指定的路径无效(例如,它位于未映射的驱动器上)。
//
// System.NotSupportedException:
// path 包含一个冒号字符 (:),该冒号字符不是驱动器标签(“C:\”)的一部分。
[SecuritySafeCritical]
public static DirectoryInfo CreateDirectory(string path, DirectorySecurity directorySecurity);
//
// 摘要:
// 从指定路径删除空目录。
//
// 参数:
// path:
// 要移除的空目录的名称。此目录必须为可写或为空。
//
// 异常:
// System.IO.IOException:
// 存在具有相同名称和 path 指定的位置的文件。- 或 -该目录为应用程序的当前工作目录。- 或 -由 path 指定的目录不为空。
//
// System.UnauthorizedAccessException:
// 调用方没有所要求的权限。- 或 -目录中包含一个只读文件。
//
// System.ArgumentException:
// path 是一个零长度字符串,仅包含空白或者包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// System.ArgumentNullException:
// path 为 null。
//
// System.IO.PathTooLongException:
// 指定的路径、文件名或者两者都超出了系统定义的最大长度。例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260
// 个字符。
//
// System.IO.DirectoryNotFoundException:
// 指定的路径不存在或未能找到。- 或 -指定的路径无效(例如,它位于未映射的驱动器上)。
[SecuritySafeCritical]
public static void Delete(string path);
//
// 摘要:
// 删除指定的目录并(如果指示)删除该目录中的任何子目录。
//
// 参数:
// path:
// 要移除的目录的名称。
//
// recursive:
// 若要移除 path 中的目录、子目录和文件,则为 true;否则为 false。
//
// 异常:
// System.IO.IOException:
// 存在具有相同名称和 path 指定的位置的文件。- 或 -path 指定的目录是只读的,或者 recursive 是 false 并且 path
// 不是空目录。- 或 -该目录为应用程序的当前工作目录。
//
// System.UnauthorizedAccessException:
// 调用方没有所要求的权限。- 或 -目录中包含一个只读文件。
//
// System.ArgumentException:
// path 是一个零长度字符串,仅包含空白或者包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// System.ArgumentNullException:
// path 为 null。
//
// System.IO.PathTooLongException:
// 指定的路径、文件名或者两者都超出了系统定义的最大长度。例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260
// 个字符。
//
// System.IO.DirectoryNotFoundException:
// 指定的路径不存在或未能找到。- 或 -指定的路径无效(例如,它位于未映射的驱动器上)。
[SecuritySafeCritical]
public static void Delete(string path, bool recursive);
//
// 摘要:
// 返回指定路径中的目录名称的可枚举集合。
//
// 参数:
// path:
// 要搜索的目录。
//
// 返回结果:
// 由 path 指定的目录中的目录名称的可枚举集合。
//
// 异常:
// System.ArgumentException:
// path 是零长度字符串、只包含空白或者包含在 System.IO.Path.GetInvalidPathChars() 定义的无效字符。
//
// System.ArgumentNullException:
// path 为 null。
//
// System.IO.DirectoryNotFoundException:
// path 无效,比如引用未映射的驱动器。
//
// System.IO.IOException:
// path 是一个文件名。
//
// System.IO.PathTooLongException:
// 指定的路径、文件名或者两者都超出了系统定义的最大长度。例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260
// 个字符。
//
// System.Security.SecurityException:
// 调用方没有所要求的权限。
//
// System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
public static IEnumerable<string> EnumerateDirectories(string path);
//
// 摘要:
// 返回指定路径中与搜索模式匹配的目录名称的可枚举集合。
//
// 参数:
// path:
// 要搜索的目录。
//
// searchPattern:
// 要与 path 中的目录名称匹配的搜索字符串。
//
// 返回结果:
// 由 path 指定的目录中与 searchPattern 匹配的目录名称的可枚举集合。
//
// 异常:
// System.ArgumentException:
// path 是零长度字符串、只包含空白或者包含在 System.IO.Path.GetInvalidPathChars() 定义的无效字符。- 或
// -searchPattern 不包含有效模式。
//
// System.ArgumentNullException:
// path 为 null。- 或 -searchPattern 为 null。
//
// System.IO.DirectoryNotFoundException:
// path 无效,比如引用未映射的驱动器。
//
// System.IO.IOException:
// path 是一个文件名。
//
// System.IO.PathTooLongException:
// 指定的路径、文件名或者两者都超出了系统定义的最大长度。例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260
// 个字符。
//
// System.Security.SecurityException:
// 调用方没有所要求的权限。
//
// System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
public static IEnumerable<string> EnumerateDirectories(string path, string searchPattern);
//
// 摘要:
// 返回指定路径中与搜索模式匹配的目录名称的可枚举集合,还可以搜索子目录。
//
// 参数:
// path:
// 要搜索的目录。
//
// searchPattern:
// 要与 path 中的目录名称匹配的搜索字符串。
//
// searchOption:
// System.IO.SearchOption 枚举的一个值,指定搜索操作是应仅包含当前目录还是应包含所有子目录。默认值为 System.IO.SearchOption.TopDirectoryOnly。
//
// 返回结果:
// 由 path 指定的目录中与 searchPattern 和 searchOption 匹配的目录名称的可枚举集合。
//
// 异常:
// System.ArgumentException:
// path 是零长度字符串、只包含空白或者包含在 System.IO.Path.GetInvalidPathChars() 定义的无效字符。- 或
// -searchPattern 不包含有效模式。
//
// System.ArgumentNullException:
// path 为 null。- 或 -searchPattern 为 null。
//
// System.ArgumentOutOfRangeException:
// searchOption 不是有效的 System.IO.SearchOption 值。
//
// System.IO.DirectoryNotFoundException:
// path 无效,比如引用未映射的驱动器。
//
// System.IO.IOException:
// path 是一个文件名。
//
// System.IO.PathTooLongException:
// 指定的路径、文件名或者两者都超出了系统定义的最大长度。例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260
// 个字符。
//
// System.Security.SecurityException:
// 调用方没有所要求的权限。
//
// System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
public static IEnumerable<string> EnumerateDirectories(string path, string searchPattern, SearchOption searchOption);
//
// 摘要:
// 返回指定路径中的文件名的可枚举集合。
//
// 参数:
// path:
// 要搜索的目录。
//
// 返回结果:
// 由 path 指定的目录中的文件名称的可枚举集合。
//
// 异常:
// System.ArgumentException:
// path 是零长度字符串、只包含空白或者包含在 System.IO.Path.GetInvalidPathChars() 定义的无效字符。
//
// System.ArgumentNullException:
// path 为 null。
//
// System.IO.DirectoryNotFoundException:
// path 无效,比如引用未映射的驱动器。
//
// System.IO.IOException:
// path 是一个文件名。
//
// System.IO.PathTooLongException:
// 指定的路径、文件名或者两者都超出了系统定义的最大长度。例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260
// 个字符。
//
// System.Security.SecurityException:
// 调用方没有所要求的权限。
//
// System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
public static IEnumerable<string> EnumerateFiles(string path);
//
// 摘要:
// 返回指定路径中与搜索模式匹配的文件名称的可枚举集合。
//
// 参数:
// path:
// 要搜索的目录。
//
// searchPattern:
// 要与 path 中的目录名称匹配的搜索字符串。
//
// 返回结果:
// 由 path 指定的目录中与 searchPattern 匹配的文件名称的可枚举集合。
//
// 异常:
// System.ArgumentException:
// path 是零长度字符串、只包含空白或者包含在 System.IO.Path.GetInvalidPathChars() 定义的无效字符。- 或
// -searchPattern 不包含有效模式。
//
// System.ArgumentNullException:
// path 为 null。- 或 -searchPattern 为 null。
//
// System.IO.DirectoryNotFoundException:
// path 无效,比如引用未映射的驱动器。
//
// System.IO.IOException:
// path 是一个文件名。
//
// System.IO.PathTooLongException:
// 指定的路径、文件名或者两者都超出了系统定义的最大长度。例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260
// 个字符。
//
// System.Security.SecurityException:
// 调用方没有所要求的权限。
//
// System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
public static IEnumerable<string> EnumerateFiles(string path, string searchPattern);
//
// 摘要:
// 返回指定路径中与搜索模式匹配的文件名称的可枚举集合,还可以搜索子目录。
//
// 参数:
// path:
// 要搜索的目录。
//
// searchPattern:
// 要与 path 中的目录名称匹配的搜索字符串。
//
// searchOption:
// System.IO.SearchOption 枚举的一个值,指定搜索操作是应仅包含当前目录还是应包含所有子目录。默认值为 System.IO.SearchOption.TopDirectoryOnly。
//
// 返回结果:
// 由 path 指定的目录中与 searchPattern 和 searchOption 匹配的文件名称的可枚举集合。
//
// 异常:
// System.ArgumentException:
// path 是零长度字符串、只包含空白或者包含在 System.IO.Path.GetInvalidPathChars() 定义的无效字符。- 或
// -searchPattern 不包含有效模式。
//
// System.ArgumentNullException:
// path 为 null。- 或 -searchPattern 为 null。
//
// System.ArgumentOutOfRangeException:
// searchOption 不是有效的 System.IO.SearchOption 值。
//
// System.IO.DirectoryNotFoundException:
// path 无效,比如引用未映射的驱动器。
//
// System.IO.IOException:
// path 是一个文件名。
//
// System.IO.PathTooLongException:
// 指定的路径、文件名或者两者都超出了系统定义的最大长度。例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260
// 个字符。
//
// System.Security.SecurityException:
// 调用方没有所要求的权限。
//
// System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
public static IEnumerable<string> EnumerateFiles(string path, string searchPattern, SearchOption searchOption);
//
// 摘要:
// 返回指定路径中的文件系统项的可枚举集合。
//
// 参数:
// path:
// 要搜索的目录。
//
// 返回结果:
// 由 path 指定的目录中的文件系统项的可枚举集合。
//
// 异常:
// System.ArgumentException:
// path 是零长度字符串、只包含空白或者包含在 System.IO.Path.GetInvalidPathChars() 定义的无效字符。
//
// System.ArgumentNullException:
// path 为 null。
//
// System.IO.DirectoryNotFoundException:
// path 无效,比如引用未映射的驱动器。
//
// System.IO.IOException:
// path 是一个文件名。
//
// System.IO.PathTooLongException:
// 指定的路径、文件名或者两者都超出了系统定义的最大长度。例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260
// 个字符。
//
// System.Security.SecurityException:
// 调用方没有所要求的权限。
//
// System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
public static IEnumerable<string> EnumerateFileSystemEntries(string path);
//
// 摘要:
// 返回指定路径中与搜索模式匹配的文件系统项的可枚举集合。
//
// 参数:
// path:
// 要搜索的目录。
//
// searchPattern:
// 要与 path 中的目录名称匹配的搜索字符串。
//
// 返回结果:
// 由 path 指定的目录中与 searchPattern 匹配的文件系统项的可枚举集合。
//
// 异常:
// System.ArgumentException:
// path 是零长度字符串、只包含空白或者包含在 System.IO.Path.GetInvalidPathChars() 定义的无效字符。- 或
// -searchPattern 不包含有效模式。
//
// System.ArgumentNullException:
// path 为 null。- 或 -searchPattern 为 null。
//
// System.IO.DirectoryNotFoundException:
// path 无效,比如引用未映射的驱动器。
//
// System.IO.IOException:
// path 是一个文件名。
//
// System.IO.PathTooLongException:
// 指定的路径、文件名或者两者都超出了系统定义的最大长度。例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260
// 个字符。
//
// System.Security.SecurityException:
// 调用方没有所要求的权限。
//
// System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
public static IEnumerable<string> EnumerateFileSystemEntries(string path, string searchPattern);
//
// 摘要:
// 返回指定路径中与搜索模式匹配的文件名称和目录名称的可枚举集合,还可以搜索子目录。
//
// 参数:
// path:
// 要搜索的目录。
//
// searchPattern:
// 要与 path 中的目录名称匹配的搜索字符串。
//
// searchOption:
// System.IO.SearchOption 枚举的一个值,指定搜索操作是应仅包含当前目录还是应包含所有子目录。默认值为 System.IO.SearchOption.TopDirectoryOnly。
//
// 返回结果:
// 由 path 指定的目录中与 searchPattern 和 searchOption 匹配的文件系统项的可枚举集合。
//
// 异常:
// System.ArgumentException:
// path 是零长度字符串、只包含空白或者包含在 System.IO.Path.GetInvalidPathChars() 定义的无效字符。- 或
// -searchPattern 不包含有效模式。
//
// System.ArgumentNullException:
// path 为 null。- 或 -searchPattern 为 null。
//
// System.ArgumentOutOfRangeException:
// searchOption 不是有效的 System.IO.SearchOption 值。
//
// System.IO.DirectoryNotFoundException:
// path 无效,比如引用未映射的驱动器。
//
// System.IO.IOException:
// path 是一个文件名。
//
// System.IO.PathTooLongException:
// 指定的路径、文件名或者两者都超出了系统定义的最大长度。例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260
// 个字符。
//
// System.Security.SecurityException:
// 调用方没有所要求的权限。
//
// System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
public static IEnumerable<string> EnumerateFileSystemEntries(string path, string searchPattern, SearchOption searchOption);
//
// 摘要:
// 确定给定路径是否引用磁盘上的现有目录。
//
// 参数:
// path:
// 要测试的路径。
//
// 返回结果:
// 如果 path 引用现有目录,则为 true;否则为 false。
[SecuritySafeCritical]
public static bool Exists(string path);
//
// 摘要:
// 获取一个 System.Security.AccessControl.DirectorySecurity 对象,该对象封装指定目录的访问控制列表
// (ACL) 项。
//
// 参数:
// path:
// 包含 System.Security.AccessControl.DirectorySecurity 对象的目录的路径,该对象描述文件的访问控制列表
// (ACL) 信息。
//
// 返回结果:
// 一个 System.Security.AccessControl.DirectorySecurity 对象,该对象封装 path 参数所描述的文件的访问控制规则。
//
// 异常:
// System.ArgumentNullException:
// path 参数为 null。
//
// System.IO.IOException:
// 打开目录时发生 I/O 错误。
//
// System.PlatformNotSupportedException:
// 当前操作系统不是 Windows 2000 或更高版本。
//
// System.SystemException:
// 未能找到目录。
//
// System.UnauthorizedAccessException:
// path 参数指定了一个只读目录。- 或 -在当前平台上不支持此操作。- 或 -调用方没有所要求的权限。
public static DirectorySecurity GetAccessControl(string path);
//
// 摘要:
// 获取一个 System.Security.AccessControl.DirectorySecurity 对象,它封装指定目录的指定类型的访问控制列表
// (ACL) 项。
//
// 参数:
// path:
// 包含 System.Security.AccessControl.DirectorySecurity 对象的目录的路径,该对象描述文件的访问控制列表
// (ACL) 信息。
//
// includeSections:
// System.Security.AccessControl.AccessControlSections 值之一,它指定要接收的访问控制列表 (ACL)
// 信息的类型。
//
// 返回结果:
// 一个 System.Security.AccessControl.DirectorySecurity 对象,该对象封装 path 参数所描述的文件的访问控制规则。
//
// 异常:
// System.ArgumentNullException:
// path 参数为 null。
//
// System.IO.IOException:
// 打开目录时发生 I/O 错误。
//
// System.PlatformNotSupportedException:
// 当前操作系统不是 Windows 2000 或更高版本。
//
// System.SystemException:
// 未能找到目录。
//
// System.UnauthorizedAccessException:
// path 参数指定了一个只读目录。- 或 -在当前平台上不支持此操作。- 或 -调用方没有所要求的权限。
public static DirectorySecurity GetAccessControl(string path, AccessControlSections includeSections);
//
// 摘要:
// 获取目录的创建日期和时间。
//
// 参数:
// path:
// 目录的路径。
//
// 返回结果:
// 一个 System.DateTime 结构,它设置为指定目录的创建日期和时间。该值用本地时间表示。
//
// 异常:
// System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
//
// System.ArgumentException:
// path 是一个零长度字符串,仅包含空白或者包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// System.ArgumentNullException:
// path 为 null。
//
// System.IO.PathTooLongException:
// 指定的路径、文件名或者两者都超出了系统定义的最大长度。例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260
// 个字符。
[SecuritySafeCritical]
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
// 个字符。
[SecuritySafeCritical]
public static DateTime GetCreationTimeUtc(string path);
//
// 摘要:
// 获取应用程序的当前工作目录。
//
// 返回结果:
// 包含当前工作目录的路径的字符串。
//
// 异常:
// System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
//
// System.NotSupportedException:
// 操作系统为 Windows CE,该系统不具有当前目录功能。此方法在 .NET Compact Framework 中可用,但是当前并不支持。
[SecuritySafeCritical]
public static string GetCurrentDirectory();
//
// 摘要:
// 获取指定目录中子目录的名称。
//
// 参数:
// path:
// 为其返回子目录名称的数组的路径。
//
// 返回结果:
// path 中子目录名称的数组。
//
// 异常:
// System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
//
// System.ArgumentException:
// path 是一个零长度字符串,仅包含空白或者包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// System.ArgumentNullException:
// path 为 null。
//
// System.IO.PathTooLongException:
// 指定的路径、文件名或者两者都超出了系统定义的最大长度。例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260
// 个字符。
//
// System.IO.IOException:
// path 是一个文件名。
//
// System.IO.DirectoryNotFoundException:
// 指定的路径无效(例如,它位于未映射的驱动器上)。
public static string[] GetDirectories(string path);
//
// 摘要:
// 从当前目录获取与指定搜索模式匹配的目录的数组。
//
// 参数:
// path:
// 要搜索的路径。
//
// searchPattern:
// 要与 path 中的文件名匹配的搜索字符串。此参数不能以两个句点(“..”)结束,不能在 System.IO.Path.DirectorySeparatorChar
// 或 System.IO.Path.AltDirectorySeparatorChar 的前面包含两个句点(“..”),也不能包含 System.IO.Path.InvalidPathChars
// 中的任何字符。
//
// 返回结果:
// 与搜索模式匹配的目录的 String 数组。
//
// 异常:
// System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
//
// System.ArgumentException:
// path 是一个零长度字符串,仅包含空白或者包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。-
// 或 -searchPattern 不包含有效模式。
//
// System.ArgumentNullException:
// path 或 searchPattern 为 null。
//
// System.IO.PathTooLongException:
// 指定的路径、文件名或者两者都超出了系统定义的最大长度。例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260
// 个字符。
//
// System.IO.IOException:
// path 是一个文件名。
//
// System.IO.DirectoryNotFoundException:
// 指定的路径无效(例如,它位于未映射的驱动器上)。
public static string[] GetDirectories(string path, string searchPattern);
//
// 摘要:
// 获取当前目录中与指定搜索模式匹配并使用某个值确定是否在子目录中搜索的目录的数组。
//
// 参数:
// path:
// 要搜索的路径。
//
// searchPattern:
// 要与 path 中的文件名匹配的搜索字符串。此参数不能以两个句点(“..”)结束,不能在 System.IO.Path.DirectorySeparatorChar
// 或 System.IO.Path.AltDirectorySeparatorChar 的前面包含两个句点(“..”),也不能包含 System.IO.Path.InvalidPathChars
// 中的任何字符。
//
// searchOption:
// System.IO.SearchOption 值之一,指定搜索操作应包括所有子目录还是仅包括当前目录。
//
// 返回结果:
// 与搜索模式匹配的目录的 String 数组。
//
// 异常:
// System.ArgumentException:
// path 是一个零长度字符串,仅包含空白或者包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。-
// 或 -searchPattern 不包含有效模式。
//
// System.ArgumentNullException:
// path 或 searchPattern 为 null。
//
// System.ArgumentOutOfRangeException:
// searchOption 不是有效的 System.IO.SearchOption 值。
//
// System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
//
// System.IO.PathTooLongException:
// 指定的路径、文件名或者两者都超出了系统定义的最大长度。例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260
// 个字符。
//
// System.IO.IOException:
// path 是一个文件名。
//
// System.IO.DirectoryNotFoundException:
// 指定的路径无效(例如,它位于未映射的驱动器上)。
public static string[] GetDirectories(string path, string searchPattern, SearchOption searchOption);
//
// 摘要:
// 返回指定路径的卷信息、根信息或两者同时返回。
//
// 参数:
// path:
// 文件或目录的路径。
//
// 返回结果:
// 包含指定路径的卷信息、根信息或同时包括这两者的字符串。
//
// 异常:
// System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
//
// System.ArgumentException:
// path 是一个零长度字符串,仅包含空白或者包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// System.ArgumentNullException:
// path 为 null。
//
// System.IO.PathTooLongException:
// 指定的路径、文件名或者两者都超出了系统定义的最大长度。例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260
// 个字符。
[SecuritySafeCritical]
public static string GetDirectoryRoot(string path);
//
// 摘要:
// 返回指定目录中的文件的名称。
//
// 参数:
// path:
// 将从其检索文件的目录。
//
// 返回结果:
// 指定目录中文件名的 String 数组。
//
// 异常:
// System.IO.IOException:
// path 是一个文件名。- 或 -发生了网络错误。
//
// System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
//
// System.ArgumentException:
// path 是一个零长度字符串,仅包含空白或者包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// System.ArgumentNullException:
// path 为 null。
//
// System.IO.PathTooLongException:
// 指定的路径、文件名或者两者都超出了系统定义的最大长度。例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260
// 个字符。
//
// System.IO.DirectoryNotFoundException:
// 指定的路径无效(例如,它位于未映射的驱动器上)。
public static string[] GetFiles(string path);
//
// 摘要:
// 返回指定目录中与指定搜索模式匹配的文件的名称。
//
// 参数:
// path:
// 要搜索的目录。
//
// searchPattern:
// 要与 path 中的文件名匹配的搜索字符串。此参数不能以两个句点(“..”)结束,不能在 System.IO.Path.DirectorySeparatorChar
// 或 System.IO.Path.AltDirectorySeparatorChar 的前面包含两个句点(“..”),也不能包含 System.IO.Path.InvalidPathChars
// 中的任何字符。
//
// 返回结果:
// 一个 String 数组,它包含指定目录中与指定搜索模式匹配的文件的名称。
//
// 异常:
// System.IO.IOException:
// path 是一个文件名。- 或 -发生了网络错误。
//
// System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
//
// System.ArgumentException:
// path 是一个零长度字符串,仅包含空白或者包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。-
// 或 -searchPattern 不包含有效模式。
//
// System.ArgumentNullException:
// path 或 searchPattern 为 null。
//
// System.IO.PathTooLongException:
// 指定的路径、文件名或者两者都超出了系统定义的最大长度。例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260
// 个字符。
//
// System.IO.DirectoryNotFoundException:
// 指定的路径无效(例如,它位于未映射的驱动器上)。
public static string[] GetFiles(string path, string searchPattern);
//
// 摘要:
// 返回指定目录中文件的名称,该目录与指定搜索模式匹配并使用某个值确定是否在子目录中搜索。
//
// 参数:
// path:
// 要搜索的目录。
//
// searchPattern:
// 要与 path 中的文件名匹配的搜索字符串。此参数不能以两个句点(“..”)结束,不能在 System.IO.Path.DirectorySeparatorChar
// 或 System.IO.Path.AltDirectorySeparatorChar 的前面包含两个句点(“..”),也不能包含 System.IO.Path.InvalidPathChars
// 中的任何字符。
//
// searchOption:
// System.IO.SearchOption 值之一,指定搜索操作应包括所有子目录还是仅包括当前目录。
//
// 返回结果:
// 一个 String 数组,它包含指定目录中与指定搜索模式匹配的文件的名称。文件名包含完整路径。
//
// 异常:
// System.ArgumentException:
// path 是一个零长度字符串,仅包含空白或者包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。-
// 或 -searchPattern 不包含有效模式。
//
// System.ArgumentNullException:
// path 或 searchpattern 为 null。
//
// System.ArgumentOutOfRangeException:
// searchOption 不是有效的 System.IO.SearchOption 值。
//
// System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
//
// System.IO.DirectoryNotFoundException:
// 指定的路径无效(例如,它位于未映射的驱动器上)。
//
// System.IO.PathTooLongException:
// 指定的路径、文件名或者两者都超出了系统定义的最大长度。例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260
// 个字符。
//
// System.IO.IOException:
// path 是一个文件名。- 或 -发生了网络错误。
public static string[] GetFiles(string path, string searchPattern, SearchOption searchOption);
//
// 摘要:
// 返回指定目录中所有文件和子目录的名称。
//
// 参数:
// path:
// 为其返回文件名和子目录名的目录。
//
// 返回结果:
// 包含指定目录中文件和子目录的名称的数组。
//
// 异常:
// System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
//
// System.ArgumentException:
// path 是一个零长度字符串,仅包含空白或者包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// System.ArgumentNullException:
// path 为 null。
//
// System.IO.PathTooLongException:
// 指定的路径、文件名或者两者都超出了系统定义的最大长度。例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260
// 个字符。
//
// System.IO.IOException:
// path 是一个文件名。
//
// System.IO.DirectoryNotFoundException:
// 指定的路径无效(例如,它位于未映射的驱动器上)。
public static string[] GetFileSystemEntries(string path);
//
// 摘要:
// 返回与指定搜索条件匹配的文件系统项的数组。
//
// 参数:
// path:
// 要搜索的路径。
//
// searchPattern:
// 要与 path 中的文件名匹配的搜索字符串。此 searchPattern 参数不能以两个句点(“..”)结束,不能在 System.IO.Path.DirectorySeparatorChar
// 或 System.IO.Path.AltDirectorySeparatorChar 的前面包含两个句点(“..”),也不能包含 System.IO.Path.InvalidPathChars
// 中的任何字符。
//
// 返回结果:
// 一个数组,包含与搜索条件匹配的文件系统项。
//
// 异常:
// System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
//
// System.ArgumentException:
// path 是一个零长度字符串,仅包含空白或者包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。-
// 或 -searchPattern 不包含有效模式。
//
// System.ArgumentNullException:
// path 或 searchPattern 为 null。
//
// System.IO.PathTooLongException:
// 指定的路径、文件名或者两者都超出了系统定义的最大长度。例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260
// 个字符。
//
// System.IO.IOException:
// path 是一个文件名。
//
// System.IO.DirectoryNotFoundException:
// 指定的路径无效(例如,它位于未映射的驱动器上)。
public static string[] GetFileSystemEntries(string path, string searchPattern);
//
// 摘要:
// 获取指定路径中与搜索模式匹配的所有文件名称和目录名称的数组,还可以搜索子目录。
//
// 参数:
// path:
// 要搜索的目录。
//
// searchPattern:
// 用于搜索与其搜索模式匹配的所有文件或目录的字符串。默认模式为“*”,该模式返回所有文件和目录。
//
// searchOption:
// 该选项指定搜索操作应仅包括当前目录还是应包括所有子目录。默认值为 System.IO.SearchOption.TopDirectoryOnly。
//
// 返回结果:
// 一个数组,包含与搜索条件匹配的文件系统项。
//
// 异常:
// System.ArgumentException:
// path 是零长度字符串、只包含空白或者包含在 System.IO.Path.GetInvalidPathChars() 定义的无效字符。- 或
// -searchPattern 不包含有效模式。
//
// System.ArgumentNullException:
// path 为 null。- 或 -searchPattern 为 null。
//
// System.ArgumentOutOfRangeException:
// searchOption 不是有效的 System.IO.SearchOption 值。
//
// System.IO.DirectoryNotFoundException:
// path 无效,比如引用未映射的驱动器。
//
// System.IO.IOException:
// path 是一个文件名。
//
// System.IO.PathTooLongException:
// 指定的路径、文件名或者两者都超出了系统定义的最大长度。例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260
// 个字符。
//
// System.Security.SecurityException:
// 调用方没有所要求的权限。
//
// System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
public static string[] GetFileSystemEntries(string path, string searchPattern, SearchOption searchOption);
//
// 摘要:
// 返回上次访问指定文件或目录的日期和时间。
//
// 参数:
// 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 参数的格式无效。
[SecuritySafeCritical]
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 参数的格式无效。
[SecuritySafeCritical]
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
// 个字符。
[SecuritySafeCritical]
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
// 个字符。
[SecuritySafeCritical]
public static DateTime GetLastWriteTimeUtc(string path);
//
// 摘要:
// 检索此计算机上格式为“<盘符>:\”的逻辑驱动器的名称。
//
// 返回结果:
// 此计算机上的逻辑驱动器。
//
// 异常:
// System.IO.IOException:
// 发生 I/O 错误(例如,磁盘错误)。
//
// System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
[SecuritySafeCritical]
public static string[] GetLogicalDrives();
//
// 摘要:
// 检索指定路径的父目录,包括绝对路径和相对路径。
//
// 参数:
// path:
// 用于检索父目录的路径。
//
// 返回结果:
// 父目录;如果 path 是根目录,包括 UNC 服务器或共享名的根,则为 null。
//
// 异常:
// System.IO.IOException:
// path 指定的目录是只读的。
//
// System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
//
// System.ArgumentException:
// path 是一个零长度字符串,仅包含空白或者包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// System.ArgumentNullException:
// path 为 null。
//
// System.IO.PathTooLongException:
// 指定的路径、文件名或者两者都超出了系统定义的最大长度。例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260
// 个字符。
//
// System.IO.DirectoryNotFoundException:
// 未找到指定的路径。
[SecuritySafeCritical]
public static DirectoryInfo GetParent(string path);
//
// 摘要:
// 将文件或目录及其内容移到新位置。
//
// 参数:
// sourceDirName:
// 要移动的文件或目录的路径。
//
// destDirName:
// 指向 sourceDirName 的新位置的路径。如果 sourceDirName 是一个文件,则 destDirName 也必须是一个文件名。
//
// 异常:
// System.IO.IOException:
// 尝试将一个目录移到不同的卷。- 或 -destDirName 已存在。- 或 -sourceDirName 和 destDirName 参数引用相同的文件或目录。
//
// System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
//
// System.ArgumentException:
// sourceDirName 或 destDirName 是一个零长度字符串,仅包含空白或者包含一个或多个由 System.IO.Path.InvalidPathChars
// 定义的无效字符。
//
// System.ArgumentNullException:
// sourceDirName 或 destDirName 为 null。
//
// System.IO.PathTooLongException:
// 指定的路径、文件名或者两者都超出了系统定义的最大长度。例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260
// 个字符。
//
// System.IO.DirectoryNotFoundException:
// 由 sourceDirName 指定的路径无效(例如,它位于未映射的驱动器上)。
[SecuritySafeCritical]
public static void Move(string sourceDirName, string destDirName);
//
// 摘要:
// 将 System.Security.AccessControl.DirectorySecurity 对象描述的访问控制列表 (ACL) 项应用于指定的目录。
//
// 参数:
// path:
// 要从中添加或移除访问控制列表 (ACL) 项的目录。
//
// directorySecurity:
// 一个 System.Security.AccessControl.DirectorySecurity 对象,该对象描述要应用于 path 参数所描述的目录的
// ACL 项。
//
// 异常:
// System.ArgumentNullException:
// directorySecurity 参数为 null。
//
// System.IO.DirectoryNotFoundException:
// 未能找到目录。
//
// System.ArgumentException:
// path 无效。
//
// System.UnauthorizedAccessException:
// 当前进程不具有打开该文件的权限。- 或 -当前进程没有足够的特权设置 ACL 项。
//
// System.PlatformNotSupportedException:
// 当前操作系统不是 Windows 2000 或更高版本。
[SecuritySafeCritical]
public static void SetAccessControl(string path, DirectorySecurity directorySecurity);
//
// 摘要:
// 为指定的文件或目录设置创建日期和时间。
//
// 参数:
// 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.UnauthorizedAccessException:
// 调用方没有所要求的权限。
//
// System.ArgumentOutOfRangeException:
// creationTime 指定超出该操作允许的日期或时间范围的值。
//
// System.PlatformNotSupportedException:
// 当前操作系统不是 Windows NT 或更高版本。
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.UnauthorizedAccessException:
// 调用方没有所要求的权限。
//
// System.ArgumentOutOfRangeException:
// creationTime 指定超出该操作允许的日期或时间范围的值。
//
// System.PlatformNotSupportedException:
// 当前操作系统不是 Windows NT 或更高版本。
[SecuritySafeCritical]
public static void SetCreationTimeUtc(string path, DateTime creationTimeUtc);
//
// 摘要:
// 将应用程序的当前工作目录设置为指定的目录。
//
// 参数:
// path:
// 设置为当前工作目录的路径。
//
// 异常:
// System.IO.IOException:
// 发生了 I/O 错误。
//
// System.ArgumentException:
// path 是一个零长度字符串,仅包含空白或者包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// System.ArgumentNullException:
// path 为 null。
//
// System.IO.PathTooLongException:
// 指定的路径、文件名或者两者都超出了系统定义的最大长度。例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260
// 个字符。
//
// System.Security.SecurityException:
// 调用方没有访问未委托的代码所需的权限。
//
// System.IO.FileNotFoundException:
// 未找到指定的路径。
//
// System.IO.DirectoryNotFoundException:
// 未找到指定的目录。
[SecuritySafeCritical]
public static void SetCurrentDirectory(string path);
//
// 摘要:
// 设置上次访问指定文件或目录的日期和时间。
//
// 参数:
// path:
// 要设置其访问日期和时间信息的文件或目录。
//
// lastAccessTime:
// System.DateTime,它包含要为 path 的访问日期和时间设置的值。该值用本地时间表示。
//
// 异常:
// System.IO.FileNotFoundException:
// 未找到指定的路径。
//
// System.ArgumentException:
// path 是一个零长度字符串,仅包含空白或者包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// System.ArgumentNullException:
// path 为 null。
//
// System.IO.PathTooLongException:
// 指定的路径、文件名或者两者都超出了系统定义的最大长度。例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260
// 个字符。
//
// System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
//
// System.PlatformNotSupportedException:
// 当前操作系统不是 Windows NT 或更高版本。
//
// System.ArgumentOutOfRangeException:
// lastAccessTime 指定超出该操作允许的日期或时间范围的值。
public static void SetLastAccessTime(string path, DateTime lastAccessTime);
//
// 摘要:
// 设置上次访问指定文件或目录的日期和时间,其格式为协调世界时 (UTC)。
//
// 参数:
// path:
// 要设置其访问日期和时间信息的文件或目录。
//
// lastAccessTimeUtc:
// 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.UnauthorizedAccessException:
// 调用方没有所要求的权限。
//
// System.PlatformNotSupportedException:
// 当前操作系统不是 Windows NT 或更高版本。
//
// System.ArgumentOutOfRangeException:
// lastAccessTimeUtc 指定超出该操作允许的日期或时间范围的值。
[SecuritySafeCritical]
public static void SetLastAccessTimeUtc(string path, DateTime lastAccessTimeUtc);
//
// 摘要:
// 设置上次写入目录的日期和时间。
//
// 参数:
// path:
// 目录的路径。
//
// lastWriteTime:
// 上次写入目录的日期和时间。该值用本地时间表示。
//
// 异常:
// System.IO.FileNotFoundException:
// 未找到指定的路径。
//
// System.ArgumentException:
// path 是一个零长度字符串,仅包含空白或者包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// System.ArgumentNullException:
// path 为 null。
//
// System.IO.PathTooLongException:
// 指定的路径、文件名或者两者都超出了系统定义的最大长度。例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260
// 个字符。
//
// System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
//
// System.PlatformNotSupportedException:
// 当前操作系统不是 Windows NT 或更高版本。
//
// System.ArgumentOutOfRangeException:
// lastWriteTime 指定超出该操作允许的日期或时间范围的值。
public static void SetLastWriteTime(string path, DateTime lastWriteTime);
//
// 摘要:
// 设置上次写入某个目录的日期和时间,其格式为协调世界时 (UTC)。
//
// 参数:
// path:
// 目录的路径。
//
// lastWriteTimeUtc:
// 上次写入目录的日期和时间。该值用 UTC 时间表示。
//
// 异常:
// System.IO.FileNotFoundException:
// 未找到指定的路径。
//
// System.ArgumentException:
// path 是一个零长度字符串,仅包含空白或者包含一个或多个由 System.IO.Path.InvalidPathChars 定义的无效字符。
//
// System.ArgumentNullException:
// path 为 null。
//
// System.IO.PathTooLongException:
// 指定的路径、文件名或者两者都超出了系统定义的最大长度。例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260
// 个字符。
//
// System.UnauthorizedAccessException:
// 调用方没有所要求的权限。
//
// System.PlatformNotSupportedException:
// 当前操作系统不是 Windows NT 或更高版本。
//
// System.ArgumentOutOfRangeException:
// lastWriteTimeUtc 指定超出该操作允许的日期或时间范围的值。
[SecuritySafeCritical]
public static void SetLastWriteTimeUtc(string path, DateTime lastWriteTimeUtc);
}
}

文件IO

标签:

原文地址:http://www.cnblogs.com/LiangzhaoWei/p/5667486.html

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