Freigeben über


HttpLanguageRangeWithQualityHeaderValue Klasse

Definition

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
Implementiert

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:

Weitere Informationen