HttpLanguageRangeWithQualityHeaderValue 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
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
- 상속
- 특성
- 구현
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 개체를 포함하는 HttpLanguageRangeWithQualityHeaderValueCollection을 반환합니다.
생성자
HttpLanguageRangeWithQualityHeaderValue(String) |
언어 범위 정보를 사용하여 HttpLanguageRangeWithQualityHeaderValue 클래스의 새 instance 초기화합니다. |
HttpLanguageRangeWithQualityHeaderValue(String, Double) |
언어 범위 및 품질 정보를 사용하여 HttpLanguageRangeWithQualityHeaderValue 클래스의 새 instance 초기화합니다. |
속성
LanguageRange |
Accept-Language HTTP 헤더에 사용되는 HttpLanguageRangeWithQualityHeaderValue에서 언어 범위 정보의 값을 가져옵니다. |
Quality |
Accept-Language HTTP 헤더에 사용되는 HttpLanguageRangeWithQualityHeaderValue에서 qvalue 또는 quality 요소의 값을 가져옵니다. |
메서드
Parse(String) |
문자열을 HttpLanguageRangeWithQualityHeaderValue instance 변환합니다. |
ToString() |
현재 HttpLanguageRangeWithQualityHeaderValue 개체를 나타내는 문자열을 반환합니다. |
TryParse(String, HttpLanguageRangeWithQualityHeaderValue) |
문자열이 유효한 HttpLanguageRangeWithQualityHeaderValue 정보인지 여부를 확인합니다. |