HttpConnectionOptionHeaderValueCollection Класс

Определение

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

Windows.Web.Http.Headers

Представляет значение http-заголовка Подключения в HTTP-запросе.

public ref class HttpConnectionOptionHeaderValueCollection sealed : IIterable<HttpConnectionOptionHeaderValue ^>, IVector<HttpConnectionOptionHeaderValue ^>, IStringable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class HttpConnectionOptionHeaderValueCollection final : IIterable<HttpConnectionOptionHeaderValue>, IVector<HttpConnectionOptionHeaderValue>, IStringable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class HttpConnectionOptionHeaderValueCollection : IEnumerable<HttpConnectionOptionHeaderValue>, IList<HttpConnectionOptionHeaderValue>, IStringable

Public NotInheritable Class HttpConnectionOptionHeaderValueCollection
Implements IEnumerable(Of HttpConnectionOptionHeaderValue), IList(Of HttpConnectionOptionHeaderValue), IStringable

Наследование

Object Platform::Object IInspectable HttpConnectionOptionHeaderValueCollection

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute

Реализации

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

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

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

Примеры

В следующем примере кода показан метод для получения и задания заголовка HTTP Connection в объекте HttpRequestMessage с помощью свойств и методов классов HttpConnectionOptionHeaderValueCollection и HttpConnectionOptionHeaderValue .

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

        public void DemonstrateHeaderRequestConnection() {
            var request = new HttpRequestMessage();
            bool parsedOk = false;

            // Set the header with a string.
            parsedOk = request.Headers.Connection.TryParseAdd("close");

            // Set the header with a strong type.
            request.Headers.Connection.Add(new HttpConnectionOptionHeaderValue("cache-control"));

            // Get the strong type out
            foreach (var value in request.Headers.Connection) {
                System.Diagnostics.Debug.WriteLine("One of the Connection values: {0}", value.Token);
            }

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

Комментарии

HttpConnectionOptionHeaderValueCollection представляет значение http-заголовка Подключения в HTTP-запросе.

HttpConnectionOptionHeaderValueCollection — это коллекция объектов HttpConnectionOptionHeaderValue, используемых для получения сведений о подключении в заголовке HTTP-подключения .

Свойство Connection объекта HttpRequestHeaderCollection возвращает объект HttpConnectionOptionHeaderValueCollection.

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

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

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

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

Свойства

Size	Возвращает количество объектов HttpConnectionOptionHeaderValue в коллекции.

Методы

Append(HttpConnectionOptionHeaderValue)	Добавляет новый элемент HttpConnectionOptionHeaderValue в конец коллекции.
Clear()	Удаляет из коллекции все объекты HttpConnectionOptionHeaderValue .
First()	Извлекает итератор к первому элементу HttpConnectionOptionHeaderValue в коллекции.
GetAt(UInt32)	Возвращает значение HttpConnectionOptionHeaderValue по указанному индексу в коллекции.
GetMany(UInt32, HttpConnectionOptionHeaderValue[])	Извлекает элементы HttpConnectionOptionHeaderValue , которые начинаются с указанного индекса в коллекции.
GetView()	Возвращает неизменяемое представление httpConnectionOptionHeaderValueCollection.
IndexOf(HttpConnectionOptionHeaderValue, UInt32)	Извлекает индекс httpConnectionOptionHeaderValue в коллекции.
InsertAt(UInt32, HttpConnectionOptionHeaderValue)	Вставляет httpConnectionOptionHeaderValue в коллекцию по указанному индексу.
ParseAdd(String)	Анализирует и добавляет запись в httpConnectionOptionHeaderValueCollection.
RemoveAt(UInt32)	Удаляет запись по указанному индексу из httpConnectionOptionHeaderValueCollection.
RemoveAtEnd()	Удаляет последний элемент HttpConnectionOptionHeaderValue из коллекции.
ReplaceAll(HttpConnectionOptionHeaderValue[])	Заменяет все элементы HttpConnectionOptionHeaderValue в коллекции указанными элементами HttpConnectionOptionHeaderValue .
SetAt(UInt32, HttpConnectionOptionHeaderValue)	Задает httpConnectionOptionHeaderValue по указанному индексу в коллекции.
ToString()	Возвращает строку, представляющую текущий объект HttpConnectionOptionHeaderValueCollection .
TryParseAdd(String)	Пытается проанализировать и добавить указанный элемент в httpConnectionOptionHeaderValueCollection.

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

• Connection
• HttpConnectionOptionHeaderValue
• HttpRequestHeaderCollection
• HttpRequestMessage
• IIterable<T>
• IStringable
• IVector<T>