HttpLanguageRangeWithQualityHeaderValue Klasse

Referenz

Definition

Namespace:: Windows.Web.Http.Headers

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Stellt akzeptierte Sprachinformationen dar, die im HTTP-Header Accept-Language für eine HTTP-Anforderung verwendet werden.

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

Vererbung: Object Platform::Object IInspectable HttpLanguageRangeWithQualityHeaderValue

Attribute: ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementiert: IStringable

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Die HttpLanguageRangeWithQualityHeaderValue-Klasse stellt die Im Accept-Language-HTTP-Header für eine HTTP-Anforderung verwendete Accept-Language-Sprachinformationen dar.

Der Accept-Language-Header kann von Clients verwendet werden, um den Satz natürlicher Sprachen anzugeben, die in der Antwort bevorzugt werden. Ein Sprachbereich ist in IETF RFC 4647 definiert. Es handelt sich um ein Sprachtag oder ein teilweises Sprachtag, das eine Sprache oder einen Sprachbereich angibt. Beispielsweise wäre en-us amerikanisches Englisch und en-gb britisches Englisch. Während en ein Sprachbereich ist, was jede Variation von Englisch bedeutet.

Jedem Sprachbereich kann ein zugeordneter Qualitätswert zugewiesen werden, der eine Schätzung der Benutzerpräferenz für die in diesem Bereich angegebenen Sprachen darstellt. Die Qualität muss im Bereich von 0,0 bis 1,0 liegen.

Einige Empfänger behandeln die Reihenfolge, in der Sprachtags aufgelistet werden, als Hinweis auf absteigende Priorität, insbesondere für Tags, denen gleiche Qualitätswerte zugewiesen sind (kein Wert ist mit q=1 identisch). Auf dieses Verhalten kann jedoch nicht verlass werden. Um Konsistenz zu gewährleisten und die Interoperabilität zu maximieren, weisen viele Benutzer-Agents jedem Sprachtag einen eindeutigen Qualitätswert zu und listen sie gleichzeitig in der Reihenfolge der abnehmenden Qualität auf.

Die AcceptLanguage-Eigenschaft für die HttpRequestHeaderCollection gibt eine HttpLanguageRangeWithQualityHeaderValueCollection zurück, die HttpLanguageRangeWithQualityHeaderValue-Objekte enthält.

Konstruktoren

HttpLanguageRangeWithQualityHeaderValue(String)	Initialisiert eine neue instance der HttpLanguageRangeWithQualityHeaderValue-Klasse mit Sprachbereichsinformationen.
HttpLanguageRangeWithQualityHeaderValue(String, Double)	Initialisiert eine neue instance der HttpLanguageRangeWithQualityHeaderValue-Klasse mit Sprachbereichs- und Qualitätsinformationen.

Eigenschaften

LanguageRange	Ruft den Wert der Sprachbereichsinformationen aus dem HttpLanguageRangeWithQualityHeaderValue ab, der im HTTP-Header Accept-Language verwendet wird.
Quality	Ruft den Wert des qvalue oder quality factor aus dem HttpLanguageRangeWithQualityHeaderValue ab, der im HTTP-Header Accept-Language verwendet wird.

Methoden

Parse(String)	Konvertiert eine Zeichenfolge in eine HttpLanguageRangeWithQualityHeaderValue-instance.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle HttpLanguageRangeWithQualityHeaderValue-Objekt darstellt.
TryParse(String, HttpLanguageRangeWithQualityHeaderValue)	Bestimmt, ob eine Zeichenfolge gültige HttpLanguageRangeWithQualityHeaderValue-Informationen ist.

Gilt für: