Compartilhar via


HttpContentHeaderCollection Classe

Definição

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.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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 HttpContentHeaderCollection final : IIterable<IKeyValuePair<winrt::hstring, winrt::hstring const&>>, IMap<winrt::hstring, winrt::hstring const&>, 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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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 HttpContentHeaderCollection : IDictionary<string,string>, IEnumerable<KeyValuePair<string,string>>, 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
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.

Aplica-se a

Confira também