C# 中的 Uri.IsWellFormedOriginalString() 方法

2024 年 8 月 29 日 | 4 分钟阅读

如果用于创建此 **Uri** 的字符串格式良好且无需进一步转义,则可以使用 **Uri.IsWellFormedOriginalString()** 方法进行确定。C# Uri 类通过 Uri.IsWellFormedOriginalString() 方法实现对 URI(统一资源标识符)的操作。此方法用于根据 RFC 3986 中概述的 URI 语法规则,确定 URI 字符串是否格式良好。

语法

它具有以下语法:

该方法的返回值是 false 或 true,具体取决于字符串是否格式良好。

Uri.IsWellFormedOriginalString() 方法的工作原理

  • URI 格式良好:符合 URI 规范语法规则的 URI 被认为是格式良好的。这些规则之一是查询、片段、方案、权限和路径组件的正确格式。
  • 方法目的:**IsWellFormedOriginalString()** 方法确定 URI 的字符串表示是否符合这些语法要求。它确认 URI 字符串是否结构正确且可以无错误地解析。
  • 返回值:此方法返回的布尔值(true 或 false)指示提供给此方法的 URI 字符串是否格式良好。如果 URI 未损坏,则返回 true;否则返回 false。
  • 用法:在处理或利用用户提供或动态生成的 URI 字符串进行网络操作之前,开发人员通常使用此技术来验证其有效性。
  • 当 URI 字符串用于 Web 请求、解析或其他与 URI 相关的操作时,**IsWellFormedOriginalString()** 是一种有用的函数,用于验证它们是否遵循标准语法。

示例

示例 1

让我们举一个例子来说明 C# 中的 **Uri.IsWellFormedOriginalString()** 方法。

输出

The URI is well-formed.

示例 2

让我们再举一个例子来说明 C# 中的 **Uri.IsWellFormedOriginalString()** 方法。

输出

The URI is well-formed.
The URI is poorly formed.
The URI is well-formed.
The URI is poorly formed.
The URI is well-formed.
The URI is so poorly formed that the system thrown System.UriFormatException

示例 3

让我们再举一个例子来说明 C# 中的 **Uri.IsWellFormedOriginalString()** 方法。

输出

First URI: https://www.example.com/resource1
Second URI: https://www.example.org/
The URIs are not equal.
The first URI is well-formed.

结论

总之,我们可以使用 C# Uri.IsWellFormedOriginalString() 方法来验证 URI 字符串是否根据 **RFC 3986** 中概述的既定 URI 语法规则有效和正确。开发人员可以利用其功能在将用户提供或动态生成的 URI 字符串用于解析、存储或发出网络请求之前快速有效地验证它们。此方法返回一个布尔值,指示 URI 字符串是否格式良好,从而使应用程序能够更有效地处理错误和验证逻辑。它的用途涵盖了严格遵守 URI 标准对于适当的功能和安全性至关重要的场景,使其成为 C# 应用程序中 URI 处理和验证项目的重要组成部分。