HttpContentHeaderCollection Classe

Definição

Namespace:

Windows.Web.Http.Headers

Fornece uma coleção dos cabeçalhos HTTP associados ao conteúdo em uma solicitação OU resposta HTTP.

public ref class HttpContentHeaderCollection sealed : IIterable<IKeyValuePair<Platform::String ^, Platform::String ^> ^>, IMap<Platform::String ^, Platform::String ^>, 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)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class HttpContentHeaderCollection final : IIterable<IKeyValuePair<winrt::hstring, winrt::hstring const&>>, IMap<winrt::hstring, winrt::hstring const&>, 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)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class HttpContentHeaderCollection : IDictionary<string,string>, IEnumerable<KeyValuePair<string,string>>, IStringable

function HttpContentHeaderCollection()

Public NotInheritable Class HttpContentHeaderCollection
Implements IDictionary(Of String, String), IEnumerable(Of KeyValuePair(Of String, String)), IStringable

Herança

Object Platform::Object IInspectable HttpContentHeaderCollection

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementações

IMap<String,String> IDictionary<String,String> IMap<Platform::String,Platform::String> IMap<winrt::hstring,winrt::hstring> IIterable<IKeyValuePair<K,V>> IEnumerable<KeyValuePair<K,V>> IIterable<IKeyValuePair<String,String>> IEnumerable<KeyValuePair<String,String>> IIterable<IKeyValuePair<Platform::String,Platform::String>> IIterable<IKeyValuePair<winrt::hstring,winrt::hstring>> IStringable

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

O código de exemplo a seguir mostra um método para obter e definir cabeçalhos no conteúdo HTTP usando as propriedades no objeto HttpContentHeaderCollection . O namespace Windows.Web.Http.Headers tem várias classes de valor e coleção de cabeçalhos fortemente tipadas para cabeçalhos HTTP específicos que podem ser usados para obter e definir cabeçalhos com validação.

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

public void DemonstrateContentHeader()
{
    DemonstrateHeaderContentContentDisposition();
}

public void DemonstrateHeaderContentContentDisposition()
{
    var content = new HttpStringContent("");
    bool parsedOk = false;

    // Set the header with a string.
    HttpContentDispositionHeaderValue value;
    parsedOk = HttpContentDispositionHeaderValue.TryParse("attachment; filename=\"fname.ext\"", out value);
    content.Headers.ContentDisposition = value;

    // Set the header with a strong type.

    content.Headers.ContentDisposition = new HttpContentDispositionHeaderValue("attachment");
    content.Headers.ContentDisposition.FileName = "myfile.exe";


    // Get the strong type out
    System.Diagnostics.Debug.WriteLine("ContentDisposition filename: {0}={1}",
        content.Headers.ContentDisposition.DispositionType,
        content.Headers.ContentDisposition.FileName);

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

Comentários

O HttpContentHeaderCollection é uma coleção dos cabeçalhos HTTP associados ao conteúdo HTTP em uma solicitação HTTP ou uma mensagem de resposta HTTP. O objeto HttpContentHeaderCollection pode ser usado para obter ou definir os cabeçalhos específicos no conteúdo HTTP. A maioria das propriedades no objeto HttpContentHeaderCollection fornece acesso a uma coleção de contêineres para um cabeçalho HTTP específico.

O HttpContentHeaderCollection tem um construtor e também é retornado pela propriedade em HttpBufferContent, HttpFormUrlEncodedContent, HttpMultipartContent, HttpMultipartFormDataContent, HttpStreamContent e HttpStringContent, classes e a interface IHttpContent .

Enumerando a coleção em C# ou Microsoft Visual Basic

Você pode iterar por meio de um objeto HttpContentHeaderCollection em C# ou Microsoft Visual Basic. Em muitos casos, como o uso da sintaxe foreach , o compilador faz essa conversão para você e você não precisará converter IEnumerable explicitamente. Se você precisar converter explicitamente, por exemplo, se quiser chamar GetEnumerator, converta o objeto de coleção para IEnumerable<T> com um KeyValuePair de String e String como a restrição.

Construtores

HttpContentHeaderCollection()

Inicializa uma nova instância da classe HttpContentHeaderCollection .

Propriedades

ContentDisposition	Obtém ou define o objeto HttpContentDispositionHeaderValue que representa o valor de um cabeçalho HTTP Content-Disposition no conteúdo HTTP.
ContentEncoding	Obtém o HttpContentCodingHeaderValueCollection de objetos HttpContentCodingHeaderValue que representam o valor de um cabeçalho HTTP Content-Encoding no conteúdo HTTP.
ContentLanguage	Obtém o HttpLanguageHeaderValueCollection de objetos que representam o valor de um cabeçalho HTTP Content-Language no conteúdo HTTP.
ContentLength	Obtém ou define o valor do cabeçalho Http Content-Length no conteúdo HTTP.
ContentLocation	Obtém ou define o valor do cabeçalho Http Content-Location no conteúdo HTTP.
ContentMD5	Obtém ou define o valor de um cabeçalho HTTP Content-MD5 no conteúdo HTTP.
ContentRange	Obtém ou define o objeto HttpContentRangeHeaderValue que representa o valor de um cabeçalho HTTP Content-Range no conteúdo HTTP.
ContentType	Obtém ou define o objeto HttpMediaTypeHeaderValue que representa o valor de um cabeçalho Http Content-Type no conteúdo HTTP.
Expires	Obtém ou define o objeto DateTime que representa o valor de um cabeçalho HTTP Expira no conteúdo HTTP.
LastModified	Obtém ou define o objeto DateTime que representa o valor de um cabeçalho HTTP Última Modificação no conteúdo HTTP.
Size	Obtém o número de objetos no HttpContentHeaderCollection.

Métodos

Append(String, String)	Adiciona um novo item ao final de HttpContentHeaderCollection.
Clear()	Remove todos os objetos do HttpContentHeaderCollection.
First()	Recupera um iterador para o primeiro item no HttpContentHeaderCollection.
GetView()	Retorna uma exibição imutável de HttpContentHeaderCollection.
HasKey(String)	Determina se HttpContentHeaderCollection contém a chave especificada.
Insert(String, String)	Insere ou substitui um item no HttpContentHeaderCollection pela chave e pelo valor especificados.
Lookup(String)	Localiza um item no HttpContentHeaderCollection se ele existir.
Remove(String)	Remove um objeto específico do HttpContentHeaderCollection.
ToString()	Retorna uma cadeia de caracteres que representa o objeto HttpContentHeaderCollection atual.
TryAppendWithoutValidation(String, String)	Tente acrescentar o item especificado ao HttpContentHeaderCollection sem validação.

Confira também

• HttpBufferContent
• HttpFormUrlEncodedContent
• HttpMultipartContent
• HttpMultipartFormDataContent
• HttpRequestMessage
• HttpResponseMessage
• HttpStreamContent
• HttpStringContent
• IMap<K,V>
• IIterable<T>
• IStringable