5.22设置客户端偏好的语言和区域

创建于 2026 年 8 月 17 日约 1 分钟读完

全球化是互联网应用产品的发展趋势，因此，面向全球的应用产品应具备国际化功能。发送 HTTP 请求时，可通过添加 AcceptLanguageAttribute 特性来指定客户端偏好的自然语言和区域。

HTTP 声明式请求通过 AcceptLanguageAttribute 特性来设置客户端偏好的语言和区域。相应的 HTTP 声明式提取器实现为 AcceptLanguageDeclarativeExtractor 类型，该类型负责解析 AcceptLanguageAttribute 特性并构建 HttpRequestBuilder 实例所需的客户端偏好的语言和区域配置。

cs
// 在接口定义上应用，影响所有方法[AcceptLanguage("en-US")]public interface IHttpService : IHttpDeclarative{    // 在方法上应用    [AcceptLanguage("zh-CN,en;q=0.5")]    [Get("https://furion.net/")]    Task<string> GetStringAsync();    [AcceptLanguage("fr-CH, fr;q=0.9, en;q=0.8, de;q=0.7, *;q=0.5")]    [Get("https://furion.net/")]    Task<string> GetStringAsync();}

AcceptLanguageAttribute 包含以下构造函数和属性：

  • 构造函数：

    • new(language)：作用于方法或接口，配置客户端偏好的语言和区域。

  • 属性：

    • Language：客户端偏好的语言和区域（string 类型）。