Uri.IsWellFormedOriginalString 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
指示用于构造此 Uri 的字符串是否格式良好,以及它是否不需要进一步转义。
public:
bool IsWellFormedOriginalString();
public bool IsWellFormedOriginalString ();
member this.IsWellFormedOriginalString : unit -> bool
Public Function IsWellFormedOriginalString () As Boolean
返回
如果该字符串格式正确,则为 true
;否则为 false
。
注解
默认情况下,根据 RFC 2396 和 RFC 2732,该字符串被视为格式良好。 如果启用了国际资源标识符 (IIS) 或国际化域名 (IDN) 分析,则字符串将被视为按照 RFC 3986 和 RFC 3987 正确格式
如果出现以下任何情况,字符串被视为格式不佳,导致该方法返回 false。
错误 | 示例 |
---|---|
字符串未正确转义。 | 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 “备注”部分。