Поделиться через


HttpConnectionOptionHeaderValueCollection Класс

Определение

Представляет значение 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)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class HttpConnectionOptionHeaderValueCollection final : 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)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class HttpConnectionOptionHeaderValueCollection : IEnumerable<HttpConnectionOptionHeaderValue>, IList<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
Атрибуты
Реализации

Требования к 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.

Применяется к

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