HttpContentHeaderCollection Clase

Definición

Espacio de nombres:

Windows.Web.Http.Headers

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.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

Herencia

Object Platform::Object IInspectable HttpContentHeaderCollection

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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.

Consulte también

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