//
// 摘要:
// 返回指定路径字符串的目录信息。
//
// 参数:
// path:
// 文件或目录的路径。
//
// 返回结果:
// path 的目录信息;如果 path 表示根目录或为 null,则为 null。如果 path 不包含目录信息,则返回 System.String.Empty。
//
// 异常:
// T:System.ArgumentException:
// path 参数包含无效字符、为空、或仅包含空白。
//
// T:System.IO.PathTooLongException:
// 在 .NET for Windows Store apps 或 可移植类库, ,捕获该基类异常, System.IO.IOException, 、 相反。path
// 参数的长度超过系统定义的最大长度。
public static string GetDirectoryName(string path);
//
// 摘要:
// 返回指定的路径字符串的扩展名。
//
// 参数:
// path:
// 从中获取扩展名的路径字符串。
//
// 返回结果:
// 指定路径的扩展名(包含句点“.”)、或 null、或 System.String.Empty。如果 path 为 null,则 System.IO.Path.GetExtension(System.String)
// 返回 null。如果 path 不具有扩展名信息,则 System.IO.Path.GetExtension(System.String) 返回 System.String.Empty。
//
// 异常:
// T:System.ArgumentException:
// path 包含 System.IO.Path.GetInvalidPathChars 中已定义的一个或多个无效字符。
public static string GetExtension(string path);
//
// 摘要:
// 返回指定路径字符串的文件名和扩展名。
//
// 参数:
// path:
// 从中获取文件名和扩展名的路径字符串。
//
// 返回结果:
// path 中最后一个目录字符后的字符。如果 path 的最后一个字符是目录或卷分隔符,则此方法返回 System.String.Empty。如果 path
// 为 null,则此方法返回 null。
//
// 异常:
// T:System.ArgumentException:
// path 包含 System.IO.Path.GetInvalidPathChars 中已定义的一个或多个无效字符。
public static string GetFileName(string path);
//
// 摘要:
// 返回不具有扩展名的指定路径字符串的文件名。
//
// 参数:
// path:
// 文件的路径。
//
// 返回结果:
// 由 System.IO.Path.GetFileName(System.String) 返回的字符串,但不包括最后的句点 (.) 以及之后的所有字符。
//
// 异常:
// T:System.ArgumentException:
// path 包含 System.IO.Path.GetInvalidPathChars 中已定义的一个或多个无效字符。
public static string GetFileNameWithoutExtension(string path);
//
// 摘要:
// 返回指定路径字符串的绝对路径。
//
// 参数:
// path:
// 要获取其绝对路径信息的文件或目录。
//
// 返回结果:
// path 的完全限定的位置,例如“C:\MyFile.txt”。
//
// 异常:
// T:System.ArgumentException:
// path 是一个零长度字符串,仅包含空白或者包含 System.IO.Path.GetInvalidPathChars 中已定义一个或多个无效字符。– 或
// – 系统未能检索绝对路径。
//
// T:System.Security.SecurityException:
// 调用方没有所需的权限。
//
// T:System.ArgumentNullException:
// path 为 null。
//
// T:System.NotSupportedException:
// path 包含一个冒号(“:”),此冒号不是卷标识符(如,“c:\”)的一部分。
//
// T:System.IO.PathTooLongException:
// 指定的路径、文件名或者两者都超出了系统定义的最大长度。例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260 个字符。
[SecuritySafeCritical]
public static string GetFullPath(string path);