C#中如何让全可选参数的方法强制传入至少一个参数？

C#并没有直接通过参数语法强制“至少一个非空可选参数”的原生特性，但可以通过以下几种设计方案实现这个约束，替代当前的空参数检查逻辑：

方案一：参数对象模式（最推荐） #

将所有搜索参数封装成一个独立的类/记录，在类内部实现验证逻辑，确保至少一个属性有有效值。这种方式既清晰又便于维护，还能在调用阶段就约束参数合法性。

步骤1：定义参数类 #

public class DiscogsSearchParameters
{
    public string? Query { get; set; }
    public string? Title { get; set; }
    public string? ReleaseTitle { get; set; }
    public string? Credit { get; set; }
    public string? Artist { get; set; }
    // 补充其他搜索参数...

    // 验证是否至少有一个参数非空
    public bool IsValid()
    {
        return !string.IsNullOrEmpty(Query) 
            || !string.IsNullOrEmpty(Title) 
            || !string.IsNullOrEmpty(ReleaseTitle) 
            || !string.IsNullOrEmpty(Credit) 
            || !string.IsNullOrEmpty(Artist)
            // 对应其他参数的非空检查...
            ;
    }
}

步骤2：修改Search方法 #

public async Task<discogsResult.DiscogsSearchResults?> Search(DiscogsSearchParameters parameters)
{
    if (parameters == null || !parameters.IsValid())
    {
        // 建议抛出异常而非返回null，强制调用者处理参数问题
        throw new ArgumentException("必须至少提供一个搜索参数", nameof(parameters));
    }

    var discogsClient = new DiscogsClient.DiscogsClient(tokenInformation);
    var discogsSearch = new DiscogsSearch()
    {
        query = parameters.Query,
        title = parameters.Title,
        release_title = parameters.ReleaseTitle,
        credit = parameters.Credit,
        artist = parameters.Artist,
        // 映射其他参数...
    };

    return await discogsClient.SearchAsync(discogsSearch);
}

调用示例 #

// 合法调用：至少提供一个参数
await Search(new DiscogsSearchParameters { Artist = "Radiohead" });
await Search(new DiscogsSearchParameters { Title = "OK Computer" });

// 非法调用：触发参数验证失败
await Search(new DiscogsSearchParameters()); // 所有属性为空

如果想更严格，可以把验证逻辑放在参数类的构造函数中，确保创建对象时就满足条件：

public record DiscogsSearchParameters
{
    public string? Query { get; init; }
    public string? Title { get; init; }
    public string? ReleaseTitle { get; init; }
    public string? Credit { get; init; }
    public string? Artist { get; init; }

    public DiscogsSearchParameters()
    {
        if (!IsValid())
        {
            throw new ArgumentException("必须至少提供一个搜索参数");
        }
    }

    private bool IsValid()
    {
        return !string.IsNullOrEmpty(Query) 
            || !string.IsNullOrEmpty(Title) 
            || !string.IsNullOrEmpty(ReleaseTitle) 
            || !string.IsNullOrEmpty(Credit) 
            || !string.IsNullOrEmpty(Artist);
    }
}

方案二：重载方法（适合参数较少的场景） #

如果搜索参数数量不多，可以定义多个重载方法，每个重载至少包含一个必填参数，不提供无参数的重载。这样编译器会直接阻止无参调用。

实现示例 #

// 重载1：必填Query参数
public async Task<discogsResult.DiscogsSearchResults?> Search(string query, string? title = null, string? release_title = null, string? credit = null, string? artist = null, [...])
{
    return await InternalSearch(query, title, release_title, credit, artist, [...]);
}

// 重载2：必填Title参数
public async Task<discogsResult.DiscogsSearchResults?> Search(string? query = null, string title, string? release_title = null, string? credit = null, string? artist = null, [...])
{
    return await InternalSearch(query, title, release_title, credit, artist, [...]);
}

// 重载3：必填Artist参数，依此类推...
public async Task<discogsResult.DiscogsSearchResults?> Search(string? query = null, string? title = null, string? release_title = null, string? credit = null, string artist, [...])
{
    return await InternalSearch(query, title, release_title, credit, artist, [...]);
}

// 内部共用逻辑方法
private async Task<discogsResult.DiscogsSearchResults?> InternalSearch(string? query, string? title, string? release_title, string? credit, string? artist, [...])
{
    var discogsClient = new DiscogsClient.DiscogsClient(tokenInformation);
    var discogsSearch = new DiscogsSearch()
    {
        query = query,
        title = title,
        release_title = release_title,
        credit = credit,
        artist = artist,
        // 映射其他参数...
    };

    return await discogsClient.SearchAsync(discogsSearch);
}

这种方式的缺点是参数越多，需要编写的重载方法就越多，后期维护成本较高。

方案三：运行时验证+编译时提示（辅助手段） #

如果不想修改现有方法结构，可以保留原方法，但在方法开头添加断言和异常抛出，同时配合C# 8.0+的可为空引用类型，让编译器给出提示。

实现示例 #

public async Task<discogsResult.DiscogsSearchResults?> Search(string? query = null, string? title = null, string? release_title = null, string? credit = null, string? artist = null, [...])
{
    // 调试模式下触发断言，开发阶段提前发现问题
    Debug.Assert(!(string.IsNullOrEmpty(query) && string.IsNullOrEmpty(title) && string.IsNullOrEmpty(release_title) && string.IsNullOrEmpty(credit) && string.IsNullOrEmpty(artist) && [...]), "必须至少提供一个搜索参数");

    // Release模式下仍保留运行时检查，抛出异常而非返回null
    if (string.IsNullOrEmpty(query) &&
        string.IsNullOrEmpty(title) &&
        string.IsNullOrEmpty(release_title) &&
        string.IsNullOrEmpty(credit) &&
        string.IsNullOrEmpty(artist) &&
        [...])
    {
        throw new ArgumentException("必须至少提供一个搜索参数");
    }

    // 原业务逻辑...
}

这种方式不能完全强制调用者传入参数，但能在开发和运行阶段及时发现问题。

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