System.Uri.IsWellFormedOriginalString 方法

方法描述

指示用于构造此 Uri 的字符串是否格式良好,以及它是否不需要进一步转义。

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

public bool IsWellFormedOriginalString()

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
返回值 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

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

此示例取决于 URI 的方案。

默认情况下,将认为用于构造此 Uri 的字符串的格式是符合 RFC 2396 和 RFC 2732 的标准格式。

在启用国际资源标识符 (IRI) 和国际化域名 (IDN) 支持之后,用于构建此 Uri 的字符串将被认为符合 RFC 3986 和 RFC 3987 的格式要求。 用于支持 IRI 的 Punycode 名称仅包含 ASCII 字符,并且总是以 xn-- 前缀开头。

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

System.Uri.IsWellFormedOriginalString 方法例子


异常

异常 异常描述

命名空间

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 系统要求。