Compartir a través de


HttpContentHeaderCollection Clase

Definición

Proporciona una colección de los encabezados HTTP asociados al contenido en una solicitud o respuesta 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
Herencia
Object Platform::Object IInspectable HttpContentHeaderCollection
Atributos
Implementaciones
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 de Windows

Familia de dispositivos
Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

En el código de ejemplo siguiente se muestra un método para obtener y establecer encabezados en contenido HTTP mediante las propiedades del objeto HttpContentHeaderCollection . El espacio de nombres Windows.Web.Http.Headers tiene una serie de clases de valores y colección de encabezados fuertemente tipadas para encabezados HTTP específicos que se pueden usar para obtener y establecer encabezados con validación.

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());
}

Comentarios

HttpContentHeaderCollection es una colección de los encabezados HTTP asociados al contenido HTTP en una solicitud HTTP o un mensaje de respuesta HTTP. El objeto HttpContentHeaderCollection se puede usar para obtener o establecer los encabezados específicos en el contenido HTTP. La mayoría de las propiedades del objeto HttpContentHeaderCollection proporcionan acceso a una colección de contenedores para un encabezado HTTP específico.

HttpContentHeaderCollection tiene un constructor y también la devuelve la propiedad en HttpBufferContent, HttpFormUrlEncodedContent, HttpMultipartContent, HttpMultipartFormDataContent, HttpStreamContent y HttpStringContent, clases y la interfaz IHttpContent.

Enumeración de la colección en C# o Microsoft Visual Basic

Puede recorrer en iteración un objeto HttpContentHeaderCollection en C# o Microsoft Visual Basic. En muchos casos, como el uso de la sintaxis foreach , el compilador realiza esta conversión por usted y no tendrá que convertir a IEnumerable explícitamente. Si necesita convertir explícitamente, por ejemplo, si desea llamar a GetEnumerator, convierta el objeto de colección en IEnumerable<T> con un KeyValuePair de String y String como restricción.

Constructores

HttpContentHeaderCollection()

Inicializa una nueva instancia de la clase HttpContentHeaderCollection .

Propiedades

ContentDisposition

Obtiene o establece el objeto HttpContentDispositionHeaderValue que representa el valor de un encabezado HTTP Content-Disposition en el contenido HTTP.

ContentEncoding

Obtiene los objetos HttpContentCodingHeaderValueCollection de los objetos HttpContentCodingHeaderValue que representan el valor de un encabezado HTTP Content-Encoding en el contenido HTTP.

ContentLanguage

Obtiene la httpLanguageHeaderValueCollection de objetos que representan el valor de un encabezado HTTP Content-Language en el contenido HTTP.

ContentLength

Obtiene o establece el valor del encabezado HTTP Content-Length en el contenido HTTP.

ContentLocation

Obtiene o establece el valor del encabezado HTTP Content-Location en el contenido HTTP.

ContentMD5

Obtiene o establece el valor de un encabezado HTTP Content-MD5 en el contenido HTTP.

ContentRange

Obtiene o establece el objeto HttpContentRangeHeaderValue que representa el valor de un encabezado de intervalo de contenido HTTP en el contenido HTTP.

ContentType

Obtiene o establece el objeto HttpMediaTypeHeaderValue que representa el valor de un encabezado HTTP Content-Type en el contenido HTTP.

Expires

Obtiene o establece el objeto DateTime que representa el valor de un encabezado HTTP Expires en el contenido HTTP.

LastModified

Obtiene o establece el objeto DateTime que representa el valor de un encabezado HTTP Last-Modified en el contenido HTTP.

Size

Obtiene el número de objetos de HttpContentHeaderCollection.

Métodos

Append(String, String)

Agrega un nuevo elemento al final de HttpContentHeaderCollection.

Clear()

Quita todos los objetos de HttpContentHeaderCollection.

First()

Recupera un iterador en el primer elemento de HttpContentHeaderCollection.

GetView()

Devuelve una vista inmutable de HttpContentHeaderCollection.

HasKey(String)

Determina si HttpContentHeaderCollection contiene la clave especificada.

Insert(String, String)

Inserta o reemplaza un elemento en HttpContentHeaderCollection por la clave y el valor especificados.

Lookup(String)

Busca un elemento en HttpContentHeaderCollection si existe.

Remove(String)

Quita un objeto específico de HttpContentHeaderCollection.

ToString()

Devuelve una cadena que representa el objeto HttpContentHeaderCollection actual.

TryAppendWithoutValidation(String, String)

Intente anexar el elemento especificado a HttpContentHeaderCollection sin validación.

Se aplica a

Consulte también