HttpMediaTypeWithQualityHeaderValueCollection Класс

Определение

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

Windows.Web.Http.Headers

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

public ref class HttpMediaTypeWithQualityHeaderValueCollection sealed : IIterable<HttpMediaTypeWithQualityHeaderValue ^>, IVector<HttpMediaTypeWithQualityHeaderValue ^>, IStringable

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

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

Public NotInheritable Class HttpMediaTypeWithQualityHeaderValueCollection
Implements IEnumerable(Of HttpMediaTypeWithQualityHeaderValue), IList(Of HttpMediaTypeWithQualityHeaderValue), IStringable

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

Object Platform::Object IInspectable HttpMediaTypeWithQualityHeaderValueCollection

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute

Реализации

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

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

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

Примеры

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

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

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

            // Set the header with a string.
            parsedOk = request.Headers.Accept.TryParseAdd ("audio/*");
            parsedOk = request.Headers.Accept.TryParseAdd ("audio/*; q=0.2");
            parsedOk = request.Headers.Accept.TryParseAdd ("audio/*; q=0.4; mysetting=myvalue");

            // Set the header with a strong type.
            request.Headers.Accept.Add(new HttpMediaTypeWithQualityHeaderValue("audio/*", .6));

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

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

Комментарии

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

HttpMediaTypeWithQualityHeaderValueCollection — это коллекция объектов HttpMediaTypeWithQualityHeaderValue, используемых для принятия сведений в заголовке HTTP Accept .

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

Свойства

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

Методы

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

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

• Accept
• HttpMediaTypeWithQualityHeaderValue
• HttpRequestHeaderCollection
• IIterable<T>
• IStringable
• IVector<T>