.NET获取URL查询参数技巧

使用 HttpUtility.ParseQueryString 可在任意 .NET 项目中解析 URL 查询参数，适用于控制台应用；2. ASP.NET Core 中推荐使用 HttpContext.Request.Query 获取 IQueryCollection，支持大小写不敏感和多值参数；3. 无 System.Web 依赖时可手动拆分查询字符串并解码；4. .NET Core 推荐使用 QueryHelpers.ParseQuery 进行安全解析与构建，避免编码问题；根据项目类型选择合适方法，注意处理 URL 编码与多值情况。

在 .NET 中获取 URL 的查询字符串参数非常简单，主要依赖于 Uri 和 NameValueCollection 类型，尤其是在 ASP.NET 或 ASP.NET Core 环境中。下面介绍几种常用且实用的方法，适用于控制台程序、Web API、MVC 或 Blazor 等场景。

1. 使用 HttpUtility.ParseQueryString（通用方法）

这个方法适用于任何 .NET 项目，包括控制台应用。你可以通过 System.Web 命名空间中的 HttpUtility.ParseQueryString 来解析 URL 查询参数。

using System;
using System.Collections.Specialized;
using System.Web;

string url = "https://example.com/search?keyword=dotnet&page=2&sort=asc";
Uri uri = new Uri(url);
NameValueCollection queryParameters = HttpUtility.ParseQueryString(uri.Query);

string keyword = queryParameters["keyword"]; // 结果: "dotnet"
string page = queryParameters["page"];       // 结果: "2"
string sort = queryParameters["sort"];       // 结果: "asc"

说明：uri.Query 返回的是以 ? 开头的查询部分（如 "?keyword=dotnet&page=2"），ParseQueryString 会自动去掉 ? 并解析成键值对。

2. 在 ASP.NET Core 中使用 HttpContext.Request.Query

在控制器或 Razor 页面中，可以直接访问请求上下文中的 Query 属性，它返回一个 IQueryCollection，使用起来更直观。

[HttpGet]
public IActionResult Search()
{
    string keyword = Request.Query["keyword"];
    string page = Request.Query["page"];

    // 多值参数支持（如 tags=a&tags=b）
    var tags = Request.Query["tags"]; // 返回字符串集合

    return Ok(new { keyword, page, tags });
}

注意：Request.Query 是大小写不敏感的，推荐使用标准命名方式传参。

3. 手动解析（无依赖场景）

如果你不能引用 System.Web（比如在 .NET Core 控制台程序中），可以手动拆分查询字符串。

string query = "keyword=dotnet&page=2&sort=asc";
var parameters = new Dictionary();

foreach (var part in query.Split('&', StringSplitOptions.RemoveEmptyEntries))
{
    var keyValue = part.Split('=', 2);
    if (keyValue.Length == 2)
    {
        string key = Uri.UnescapeDataString(keyValue[0]);
        string value = Uri.UnescapeDataString(keyValue[1]);
        parameters[key] = value;
    }
}

这种方法虽然原始，但在轻量级工具类中很实用。

4. 使用 QueryHelpers（推荐用于 .NET Core）

.NET Core 提供了 Microsoft.AspNetCore.WebUtilities.QueryHelpers，适合构建和解析查询字符串。

using Microsoft.AspNetCore.WebUtilities;

var uri = new Uri("https://example.com?name=john&age=30");
var query = QueryHelpers.ParseQuery(uri.Query);

string name = query["name"]; // "john"
int age = int.Parse(query["age"]); // 30

优势：QueryHelpers 还支持安全地添加查询参数，避免编码问题。

基本上就这些常用的技巧。根据你的项目类型选择合适的方式：Web 项目优先用 Request.Query 或 QueryHelpers，非 Web 项目可用 HttpUtility 或手动解析。关键是处理好 URL 编码和多值参数的情况。不复杂但容易忽略细节。