다음을 통해 공유


HttpChallengeHeaderValueCollection 클래스

정의

HTTP 응답에서 Proxy-Authenticate 또는 WWW-Authenticate HTTP 헤더의 값을 나타냅니다.

public ref class HttpChallengeHeaderValueCollection sealed : IIterable<HttpChallengeHeaderValue ^>, IVector<HttpChallengeHeaderValue ^>, 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)]
class HttpChallengeHeaderValueCollection final : IIterable<HttpChallengeHeaderValue>, IVector<HttpChallengeHeaderValue>, IStringable
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class HttpChallengeHeaderValueCollection final : IIterable<HttpChallengeHeaderValue>, IVector<HttpChallengeHeaderValue>, 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)]
public sealed class HttpChallengeHeaderValueCollection : IEnumerable<HttpChallengeHeaderValue>, IList<HttpChallengeHeaderValue>, IStringable
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class HttpChallengeHeaderValueCollection : IEnumerable<HttpChallengeHeaderValue>, IList<HttpChallengeHeaderValue>, IStringable
Public NotInheritable Class HttpChallengeHeaderValueCollection
Implements IEnumerable(Of HttpChallengeHeaderValue), IList(Of HttpChallengeHeaderValue), IStringable
상속
Object Platform::Object IInspectable HttpChallengeHeaderValueCollection
특성
구현

Windows 요구 사항

디바이스 패밀리
Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract
Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

예제

다음 샘플 코드에서는 HttpChallengeHeaderValueCollection 및 HttpChallengeHeaderValue 클래스의 속성과 메서드를 사용하여 HttpResponseMessage 개체에서 Proxy-Authenticate HTTP 헤더를 가져와서 설정하는 메서드를 보여 줍니다.

using System;
using Windows.Web.Http;
using Windows.Web.Http.Headers;

        public void DemonstrateHeaderResponseProxyAuthenticate() {
            var response = new HttpResponseMessage();

            // Set the header with a strong type.
            response.Headers.ProxyAuthenticate.TryParseAdd("Basic");
            response.Headers.ProxyAuthenticate.Add(new HttpChallengeHeaderValue("authScheme", "authToken"));

            // Get the strong type out
            foreach (var value in response.Headers.ProxyAuthenticate) {
                System.Diagnostics.Debug.WriteLine("Proxy authenticate scheme and token: {0} {1}", value.Scheme, value.Token);
            }

            // The ToString() is useful for diagnostics, too.
            System.Diagnostics.Debug.WriteLine("The ProxyAuthenticate ToString() results: {0}", response.Headers.ProxyAuthenticate.ToString());
        }

설명

HttpChallengeHeaderValueCollection은 HTTP 응답에서 Proxy-Authenticate 또는 WWW-Authenticate HTTP 헤더의 값을 나타냅니다.

HttpChallengeHeaderValueCollection은 Authorization, ProxyAuthorization, WWW-AuthenticateProxy-Authenticate HTTP 헤더 값에 사용되는 인증 정보에 사용되는 HttpChallengeHeaderValue 클래스의 인스턴스에 대한 컬렉션 컨테이너를 제공합니다.

HttpResponseHeaderCollectionProxyAuthenticate 속성은 HttpChallengeHeaderValueCollection 개체를 반환합니다. HttpResponseHeaderCollectionWwwAuthenticate 속성은 HttpChallengeHeaderValueCollection 개체도 반환합니다.

컬렉션 멤버 목록

JavaScript의 경우 HttpChallengeHeaderValueCollection에는 멤버 목록에 표시된 멤버가 있습니다. 또한 HttpChallengeHeaderValueCollection은 Array.prototype 의 멤버를 지원하고 인덱스를 사용하여 항목에 액세스합니다.

C# 또는 Microsoft Visual Basic에서 컬렉션 열거

C# 또는 Microsoft Visual Basic에서 HttpChallengeHeaderValueCollection 개체를 반복할 수 있습니다. foreach 구문 사용과 같은 대부분의 경우 컴파일러는 이 캐스팅을 수행하므로 명시적으로 캐스팅 IEnumerable<HttpChallengeHeaderValue> 할 필요가 없습니다. 예를 들어 GetEnumerator를 호출하려는 경우 명시적으로 캐스팅해야 하는 경우 HttpChallengeHeaderValue 제약 조건을 사용하여 컬렉션 개체를 IEnumerable<T>로 캐스팅합니다.

속성

Size

컬렉션의 HttpChallengeHeaderValue 개체 수를 가져옵니다.

메서드

Append(HttpChallengeHeaderValue)

컬렉션의 끝에 새 HttpChallengeHeaderValue 항목을 추가합니다.

Clear()

컬렉션에서 모든 HttpChallengeHeaderValue 개체를 제거합니다.

First()

컬렉션의 첫 번째 HttpChallengeHeaderValue 항목에 대한 반복기를 검색합니다.

GetAt(UInt32)

컬렉션의 지정된 인덱 스에서 HttpChallengeHeaderValue 를 반환합니다.

GetMany(UInt32, HttpChallengeHeaderValue[])

컬렉션의 지정된 인덱스에서 시작하는 HttpChallengeHeaderValue 항목을 검색합니다.

GetView()

HttpChallengeHeaderValueCollection의 변경할 수 없는 보기를 반환합니다.

IndexOf(HttpChallengeHeaderValue, UInt32)

컬렉션에서 HttpChallengeHeaderValue 의 인덱스를 검색합니다.

InsertAt(UInt32, HttpChallengeHeaderValue)

지정된 인덱스의 컬렉션에 HttpChallengeHeaderValue 를 삽입합니다.

ParseAdd(String)

HttpChallengeHeaderValueCollection에 항목을 구문 분석하고 추가합니다.

RemoveAt(UInt32)

HttpChallengeHeaderValueCollection에서 지정된 인덱스의 항목을 제거합니다.

RemoveAtEnd()

컬렉션에서 마지막 HttpChallengeHeaderValue 항목을 제거합니다.

ReplaceAll(HttpChallengeHeaderValue[])

컬렉션의 모든 HttpChallengeHeaderValue 항목을 지정된 HttpChallengeHeaderValue 항목으로 바꿉니다.

SetAt(UInt32, HttpChallengeHeaderValue)

컬렉션의 지정된 인덱 스에서 HttpChallengeHeaderValue 를 설정합니다.

ToString()

현재 HttpChallengeHeaderValueCollection 개체를 나타내는 문자열을 반환합니다.

TryParseAdd(String)

HttpChallengeHeaderValueCollection에 지정된 항목을 구문 분석하고 추가하려고 합니다.

적용 대상

추가 정보