如何在C#中为相对URL设置查询字符串参数

由于标准System.Uri和System.UriBuilder类对相对URI的支持有限，我们可以通过解析URL结构、规范化处理查询参数的方式实现需求，同时避免手动拼接字符串带来的编码问题。以下是针对不同.NET环境的具体实现方案：

.NET Framework 实现 #

借助System.Web.HttpUtility工具类来解析和构建查询参数，它会自动处理URL编码，规避特殊字符导致的格式问题：

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

public static string AddRelativeUrlQueryParam(string relativeUrl, string paramKey, string paramValue)
{
    // 拆分URL的路径与查询字符串部分
    var queryStartIndex = relativeUrl.IndexOf('?');
    string urlPath = relativeUrl;
    var queryParams = new NameValueCollection();

    if (queryStartIndex != -1)
    {
        urlPath = relativeUrl.Substring(0, queryStartIndex);
        string existingQuery = relativeUrl.Substring(queryStartIndex + 1);
        // 解析现有查询参数到集合中
        queryParams = HttpUtility.ParseQueryString(existingQuery);
    }

    // 添加新参数（若存在同名参数会直接覆盖，如需保留多值可改用Add方法）
    queryParams[paramKey] = paramValue;

    // 拼接最终URL
    return queryParams.Count == 0 
        ? urlPath 
        : $"{urlPath}?{queryParams.ToString()}";
}

使用示例：

• 调用AddRelativeUrlQueryParam("/api/services", "type", "1") → 返回 /api/services?type=1
• 调用AddRelativeUrlQueryParam("/api/services?id=4", "type", "1") → 返回 /api/services?id=4&type=1

.NET Core/.NET 5+ 实现 #

在现代.NET环境中，推荐使用Microsoft.AspNetCore.WebUtilities中的QueryHelpers工具类，它专门针对URL查询参数设计，且不依赖System.Web：

首先安装NuGet包Microsoft.AspNetCore.WebUtilities，然后实现方法：

using Microsoft.AspNetCore.WebUtilities;
using System.Collections.Generic;

public static string AddRelativeUrlQueryParam(string relativeUrl, string paramKey, string paramValue)
{
    var queryParams = new Dictionary<string, string>();
    string urlPath = relativeUrl;

    if (relativeUrl.Contains('?'))
    {
        var urlParts = relativeUrl.Split('?', 2);
        urlPath = urlParts[0];
        // 解析现有查询参数
        var existingQuery = QueryHelpers.ParseQuery(urlParts[1]);
        foreach (var key in existingQuery.Keys)
        {
            queryParams[key] = existingQuery[key];
        }
    }

    // 添加新参数
    queryParams[paramKey] = paramValue;

    // 拼接生成最终URL
    return QueryHelpers.AddQueryString(urlPath, queryParams);
}

核心优势 #

• 自动处理URL编码：参数值包含&、=或中文等特殊字符时，工具类会自动编码，保证URL格式合法
• 兼容各类相对URL：无论是无查询参数的纯路径，还是已有多个查询参数的URL都能正确处理
• 避免手动拼接错误：无需自行处理?和&的拼接逻辑，减少出错概率

内容的提问来源于stack exchange，提问作者Khodaie