HttpLanguageRangeWithQualityHeaderValue 类

定义

命名空间:

Windows.Web.Http.Headers

表示在 HTTP 请求的 Accept-Language HTTP 标头中使用的接受语言信息。

public ref class HttpLanguageRangeWithQualityHeaderValue sealed : IStringable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Web.Http.Headers.IHttpLanguageRangeWithQualityHeaderValueFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class HttpLanguageRangeWithQualityHeaderValue final : IStringable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Web.Http.Headers.IHttpLanguageRangeWithQualityHeaderValueFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class HttpLanguageRangeWithQualityHeaderValue : IStringable

function HttpLanguageRangeWithQualityHeaderValue(languageRange, quality)

Public NotInheritable Class HttpLanguageRangeWithQualityHeaderValue
Implements IStringable

继承

Object Platform::Object IInspectable HttpLanguageRangeWithQualityHeaderValue

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

实现

IStringable

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

注解

HttpLanguageRangeWithQualityHeaderValue 类表示 HTTP 请求的 Accept-Language HTTP 标头中使用的接受语言信息。

客户端可以使用 Accept-Language 标头来指示响应中首选的自然语言集。 语言范围在 IETF RFC 4647 中定义。 它是一个语言标记或部分语言标记，指示语言或语言范围。 例如 ，en-us 为美式英语， en-gb 为英国英语。 而 en 是一个语言范围，表示英语的任何变体。

可以为每个语言范围提供一个关联的质量值，该值表示用户对该范围所指定语言的首选项的估计值。 质量必须在 0.0 到 1.0 的范围内。

某些接收方将语言标记的列出顺序视为指示降序优先级，特别是对于分配了同等质量值的标记， (没有值与 q=1) 相同。 但是，不能依赖此行为。 为了保持一致性和最大化互操作性，许多用户代理为每个语言标记分配一个唯一的质量值，同时按质量下降的顺序列出它们。

HttpRequestHeaderCollection 上的 AcceptLanguage 属性返回包含 HttpLanguageRangeWithQualityHeaderValue 对象的 HttpLanguageRangeWithQualityHeaderValue。

构造函数

HttpLanguageRangeWithQualityHeaderValue(String)	使用语言范围信息初始化 HttpLanguageRangeWithQualityHeaderValue 类的新实例。
HttpLanguageRangeWithQualityHeaderValue(String, Double)	使用语言范围和质量信息初始化 HttpLanguageRangeWithQualityHeaderValue 类的新实例。

属性

LanguageRange	从 Accept-Language HTTP 标头中使用的 HttpLanguageRangeWithQualityHeaderValue 中获取语言范围信息的值。
Quality	从 Accept-Language HTTP 标头中使用的 HttpLanguageRangeWithQualityHeaderValue 获取 qvalue 或质量因子的值。

方法

Parse(String)	将字符串转换为 HttpLanguageRangeWithQualityHeaderValue 实例。
ToString()	返回表示当前 HttpLanguageRangeWithQualityHeaderValue 对象的字符串。
TryParse(String, HttpLanguageRangeWithQualityHeaderValue)	确定字符串是否为有效的 HttpLanguageRangeWithQualityHeaderValue 信息。

另请参阅

• AcceptLanguage
• HttpLanguageRangeWithQualityHeaderValueCollection
• HttpRequestHeaderCollection
• IStringable