HttpProductInfoHeaderValueCollection Класс

Определение

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

Windows.Web.Http.Headers

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

public ref class HttpProductInfoHeaderValueCollection sealed : IIterable<HttpProductInfoHeaderValue ^>, IVector<HttpProductInfoHeaderValue ^>, IStringable

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

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

Public NotInheritable Class HttpProductInfoHeaderValueCollection
Implements IEnumerable(Of HttpProductInfoHeaderValue), IList(Of HttpProductInfoHeaderValue), IStringable

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

Object Platform::Object IInspectable HttpProductInfoHeaderValueCollection

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute

Реализации

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

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

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

Примеры

В следующем примере кода показан метод для получения и задания http-заголовка User-Agent в объекте HttpRequestMessage с помощью свойств и методов классов HttpProductInfoHeaderValueCollection и HttpProductInfoHeaderValue .

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

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

            // Set the header with a string.
            parsedOk = request.Headers.UserAgent.TryParseAdd("testprogram/1.0");

            // Set the header with a strong type.
            request.Headers.UserAgent.Add(new HttpProductInfoHeaderValue("myprogram", "2.2"));

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

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

Комментарии

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

HttpProductInfoHeaderValueCollection — это коллекция объектов HttpProductInfoHeaderValue, используемых для сведений о продукте в заголовке АГЕНТА пользователя HTTP.

Заголовок User-Agent содержит сведения об агенте пользователя, отправляющем запрос. Заголовок User-Agent может содержать несколько маркеров продукта и комментариев, определяющих агент пользователя и любые дочерние продукты.

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

Свойства

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

Методы

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

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

• HttpProductInfoHeaderValue
• HttpRequestHeaderCollection
• IIterable<T>
• IStringable
• IVector<T>
• UserAgent