HttpLanguageRangeWithQualityHeaderValue Класс

Определение

Представляет сведения о языке принятия, используемые в заголовке HTTP Accept-Language в HTTP-запросе .

public ref class HttpLanguageRangeWithQualityHeaderValue sealed : IStringable
/// [Windows.Foundation.Metadata.Activatable(Windows.Web.Http.Headers.IHttpLanguageRangeWithQualityHeaderValueFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class HttpLanguageRangeWithQualityHeaderValue final : 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.Activatable(typeof(Windows.Web.Http.Headers.IHttpLanguageRangeWithQualityHeaderValueFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class HttpLanguageRangeWithQualityHeaderValue : 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
Атрибуты
Реализации

Требования к 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 .

Применяется к

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