HttpChallengeHeaderValueCollection Класс

Определение

Пространство имен:

Windows.Web.Http.Headers

Представляет значение 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)]
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)]
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

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute

Реализации

IIterable<T> IEnumerable<T> IIterable<HttpChallengeHeaderValue> IEnumerable<HttpChallengeHeaderValue> IVector<HttpChallengeHeaderValue> IList<HttpChallengeHeaderValue> IStringable

Требования к Windows

Семейство устройств	Windows 10 (появилось в 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)

Примеры

В следующем примере кода показан метод для получения и задания http-заголовка Proxy-Authenticate в объекте HttpResponseMessage с помощью свойств и методов классов HttpChallengeHeaderValueCollection и HttpChallengeHeaderValue .

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 предоставляет контейнер коллекции для экземпляров класса HttpChallengeHeaderValue , используемых для сведений о проверке подлинности, используемых в значениях заголовков HTTP Authorization, ProxyAuthorization, WWW-Authenticate и Proxy-Authenticate .

Свойство ProxyAuthenticate в HttpResponseHeaderCollection возвращает объект HttpChallengeHeaderValueCollection. Свойство WwwAuthenticate в HttpResponseHeaderCollection также возвращает объект HttpChallengeHeaderValueCollection.

Списки элементов коллекции

Для JavaScript HttpChallengeHeaderValueCollection содержит элементы, отображаемые в списках элементов. Кроме того, HttpChallengeHeaderValueCollection поддерживает элементы Array.prototype и использует индекс для доступа к элементам.

Перечисление коллекции на C# или Microsoft Visual Basic

Вы можете выполнить итерацию по объекту HttpChallengeHeaderValueCollection в C# или Microsoft Visual Basic. Во многих случаях, например с помощью синтаксиса foreach , компилятор выполняет это приведение за вас, и вам не нужно явно приводить к IEnumerable<HttpChallengeHeaderValue> . Если необходимо выполнить приведение явным образом, например, если вы хотите вызвать GetEnumerator, приведите объект коллекции к IEnumerable<T> с ограничением HttpChallengeHeaderValue .

Свойства

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.

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

• HttpChallengeHeaderValue
• HttpResponseMessage
• HttpResponseHeaderCollection
• IIterable<T>
• IStringable
• IVector<T>
• ProxyAuthenticate
• WwwAuthenticate