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). Однако на это поведение нельзя полагаться. Для обеспечения согласованности и максимального взаимодействия многие пользовательские агенты присваивают каждому языковому тегу уникальное значение качества, а также перечисляют их в порядке снижения качества.

Свойство AcceptLanguage объекта HttpRequestHeaderCollection возвращает объект HttpLanguageRangeWithQualityHeaderValueCollection , содержащий объекты HttpLanguageRangeWithQualityHeaderValue.

Конструкторы

HttpLanguageRangeWithQualityHeaderValue(String)	Инициализирует новый экземпляр класса HttpLanguageRangeWithQualityHeaderValue со сведениями о диапазоне языка.
HttpLanguageRangeWithQualityHeaderValue(String, Double)	Инициализирует новый экземпляр класса HttpLanguageRangeWithQualityHeaderValue с помощью сведений о диапазоне языка и качестве.

Свойства

LanguageRange	Возвращает значение сведений о диапазоне языка из httpLanguageRangeWithQualityHeaderValue , используемого в http-заголовке Accept-Language .
Quality	Возвращает значение qvalue или коэффициента качества из httpLanguageRangeWithQualityHeaderValue , используемого в http-заголовке Accept-Language .

Методы

Parse(String)	Преобразует строку в экземпляр HttpLanguageRangeWithQualityHeaderValue .
ToString()	Возвращает строку, представляющую текущий объект HttpLanguageRangeWithQualityHeaderValue .
TryParse(String, HttpLanguageRangeWithQualityHeaderValue)	Определяет, является ли строка допустимыми данными HttpLanguageRangeWithQualityHeaderValue .

См. также раздел

• AcceptLanguage
• HttpLanguageRangeWithQualityHeaderValueCollection
• HttpRequestHeaderCollection
• IStringable