C# 中的 Uri.CheckSchemeName(String) 方法

2025年2月5日 | 阅读3分钟

在本文中，我们将讨论 C# 中 Uri.CheckSchemeName(String) 方法的语法、参数和示例。

C# 中的 Uri.CheckSchemeName(String) 方法是什么？

C# 中的 Uri.CheckSchemeName(String) 函数是 System 命名空间的一部分，它验证 URI 的方案名称。URI 是指特定资源的一组字符。方案是 URI 的第一个组成部分，它指定用于访问内容的协议或方案，例如“http”、“https”、“FTP”等。

CheckSchemeName 函数接受一个字符串参数，指示方案名称，如果方案名称不正确，则会引发 UriSyntaxexception。如果方案名称为 true，则返回 UriSyntaxFlags.None。

语法

它具有以下语法：

输入参数

该方法接受一个包含方案名称的字符串。这是 URI 的一部分，定义了协议或方案，可以是“http”、“https”等。

验证规则

CheckSchemeName 函数对有效的方案名称实施特定的约束。根据 URI 标准 (RFC 3986)，方案名称应以字母开头，然后是字母、数字、加号 ('+')、句号 ('.') 或连字符 ('-')。不允许有空格或其他字符。

异常处理：如果方案名称违反任何规则，该过程将发出 UriSyntaxexception。此异常包含有关错误的信息，并可由调用方代码捕获和管理。

返回值

如果方案名称有效，此函数将返回 UriSyntaxFlags.None。这意味着在方案名称中未识别出任何语法错误。如果方案名称不正确，该方法将引发 UriSyntaxexception。

示例 1

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

 
using System; 
using System.Globalization; 

class CheckScheme{ 

	// Main Method 
	public static void Main() 
	{ 
		//the Uri declaration
		Uri uri = new Uri("https://learn.microsoft.com/en-us/dotnet/api/system.uri.checkschemename?view=net-8.0"); 

		// the scheme detemination
		string Checkscheme = uri.Scheme; 

		// the CheckSchemeName() method for uri validation
		bool values = Uri.CheckSchemeName(Checkscheme); 

		// the print statement
		if (values) 
			Console.WriteLine("The Scheme name is valid"); 
		else
			Console.WriteLine("It is invalid scheme name"); 
	} 
}    

输出

 
The Scheme name is valid

示例 2

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

 
using System; 
using System.Globalization; 

class CheckScheme{ 

	// Main Method 
	public static void Main() 
	{ 
		//the Uri declaration
		Uri uri = new Uri("https://www.ox.ac.uk"); 

		// the scheme detemination
		string Checkscheme = uri.Scheme; 

		// the CheckSchemeName() method for uri validation
		bool values = Uri.CheckSchemeName(Checkscheme); 

		// the print statement
		if (values) 
			Console.WriteLine("The Scheme name is valid"); 
		else
			Console.WriteLine("It is invalid scheme name"); 
	} 
}    

输出

 
The Scheme name is valid

C# 中 Uri.CheckSchemeName(String) 方法的优点

Uri.CheckSchemeName(String) 方法有以下几个优点：

错误处理
该函数使用异常处理错误。如果方案名称错误，则会发生 UriSyntaxexception。这使开发人员能够有效捕获和处理异常，向用户显示相关错误消息或存储数据以进行调试。
安全性
验证方案名称，通过避免格式错误的 URI 带来的攻击和漏洞来提高应用程序安全性。为了消除注入攻击等安全威胁，在使用用户输入创建或处理 URI 时，需要进行适当的 URI 验证。
易用性
此函数是标准 .Net 框架的一部分，使其易于使用。开发人员可以将其添加到 URI 验证方法中，而无需复杂的自定义验证逻辑，从而减少时间和精力。

下一个主题Uri-isloopback-property-in-c-sharp

C# 中的 Uri.CheckSchemeName(String) 方法