System.Uri.IsWellFormedUriString 方法

方法描述

通过尝试用字符串构造一个 URI 来指示字符串是否为格式良好的,并确保字符串不需要进一步转义。

语法定义(C# System.Uri.IsWellFormedUriString 方法 的用法)

public static bool IsWellFormedUriString(
	string uriString,
	UriKind uriKind
)

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
uriString System-String 用于尝试构造 Uri 的字符串。
uriKind System-UriKind uriString 中的 Uri 的类型。
返回值 System.Boolean 一个 Boolean 值。如果该字符串格式正确,则该值为 true ;否则为 false。

提示和注释

默认情况下,将认为该字符串的格式是符合 RFC 2396 和 RFC 2732 的标准格式。 如果启用了国际资源标识符 (IRIs) 或国际域名称 (IDN) 分析,则根据 RFC 3986 和 RFC 3987,字符串被认为是标准格式的。

如果出现了下面的任一情况,则认为字符串的格式很差,并导致该方法返回 false

Error

示例

此字符串未正确转义。

http://www.contoso.com/path???/file name

字符串是绝对 Uri,它表示隐式文件 Uri。

c:\\directory\filename

字符串是绝对 URI,它在路径前缺少一个斜杠。

file://c:/directory/filename

字符串包含非转义反斜杠,即使这些反斜杠会被视为正斜杠

http:\\host/path/file

字符串表示分层的绝对 Uri,不包含“://”

www.contoso.com/path/file

Scheme 的分析器指示原始字符串不是格式良好的。

此示例取决于 URI 的方案。

有关 IRI 支持的更多信息,请参见 Uri 类的“备注”部分。

System.Uri.IsWellFormedUriString 方法例子


异常

异常 异常描述

命名空间

namespace: System

程序集: System(在 System.dll 中)

版本信息

.NET Framework 受以下版本支持:4、3.5、3.0、2.0 .NET Framework Client Profile 受以下版本支持:4、3.5 SP1 受以下版本支持:

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。