HttpProductInfoHeaderValueCollection Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Representa el valor del encabezado HTTP del agente de usuario en una solicitud HTTP.
public ref class HttpProductInfoHeaderValueCollection sealed : IIterable<HttpProductInfoHeaderValue ^>, IVector<HttpProductInfoHeaderValue ^>, 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)]
class HttpProductInfoHeaderValueCollection final : IIterable<HttpProductInfoHeaderValue>, IVector<HttpProductInfoHeaderValue>, IStringable
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class HttpProductInfoHeaderValueCollection final : IIterable<HttpProductInfoHeaderValue>, IVector<HttpProductInfoHeaderValue>, 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)]
public sealed class HttpProductInfoHeaderValueCollection : IEnumerable<HttpProductInfoHeaderValue>, IList<HttpProductInfoHeaderValue>, IStringable
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class HttpProductInfoHeaderValueCollection : IEnumerable<HttpProductInfoHeaderValue>, IList<HttpProductInfoHeaderValue>, IStringable
Public NotInheritable Class HttpProductInfoHeaderValueCollection
Implements IEnumerable(Of HttpProductInfoHeaderValue), IList(Of HttpProductInfoHeaderValue), IStringable
- Herencia
- Atributos
- Implementaciones
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 el encabezado HTTP del Agente de usuario en un objeto HttpRequestMessage mediante las propiedades y métodos de las clases HttpProductInfoHeaderValueCollection y HttpProductInfoHeaderValue .
using System;
using Windows.Web.Http;
using Windows.Web.Http.Headers;
public void DemonstrateHeaderRequestUserAgent() {
var request = new HttpRequestMessage();
bool parsedOk = false;
// Set the header with a string.
parsedOk = request.Headers.UserAgent.TryParseAdd("testprogram/1.0");
// Set the header with a strong type.
request.Headers.UserAgent.Add(new HttpProductInfoHeaderValue("myprogram", "2.2"));
// Get the strong type out
foreach (var value in request.Headers.UserAgent) {
System.Diagnostics.Debug.WriteLine("One of the UserAgent values: {0} / {1}", value.Product.Name, value.Product.Version);
}
// The ToString() is useful for diagnostics, too.
System.Diagnostics.Debug.WriteLine("The UserAgent ToString() results: {0}", request.Headers.UserAgent.ToString());
}
Comentarios
HttpProductInfoHeaderValueCollection representa el valor del encabezado HTTP User-Agent en una solicitud HTTP.
HttpProductInfoHeaderValueCollection es una colección de objetos HttpProductInfoHeaderValue usados para la información del producto en el encabezado Http User-Agent .
El encabezado User-Agent contiene información sobre el agente de usuario que origina la solicitud. El encabezado User-Agent puede contener varios tokens de producto y comentarios que identifican al agente de usuario y a cualquier subproducto.
La propiedad UserAgent de HttpRequestHeaderCollection devuelve un objeto HttpProductInfoHeaderValueCollection.
Propiedades
Size |
Obtiene el número de objetos HttpProductInfoHeaderValue de la colección. |
Métodos
Append(HttpProductInfoHeaderValue) |
Agrega un nuevo elemento HttpProductInfoHeaderValue al final de la colección. |
Clear() |
Quita todos los objetos de la colección. |
First() |
Recupera un iterador en el primer elemento HttpProductInfoHeaderValue de la colección. |
GetAt(UInt32) |
Devuelve HttpProductInfoHeaderValue en el índice especificado de la colección. |
GetMany(UInt32, HttpProductInfoHeaderValue[]) |
Recupera los elementos HttpProductInfoHeaderValue que comienzan en el índice especificado de la colección. |
GetView() |
Devuelve una vista inmutable de HttpProductInfoHeaderValueCollection. |
IndexOf(HttpProductInfoHeaderValue, UInt32) |
Recupera el índice de httpProductInfoHeaderValue en la colección. |
InsertAt(UInt32, HttpProductInfoHeaderValue) |
Inserta un HttpProductInfoHeaderValue en la colección en el índice especificado. |
ParseAdd(String) |
Analiza y agrega una entrada a HttpProductInfoHeaderValueCollection. |
RemoveAt(UInt32) |
Quita la entrada en el índice especificado de HttpMethodHeaderValueCollection. |
RemoveAtEnd() |
Quita el último elemento HttpProductInfoHeaderValue de la colección. |
ReplaceAll(HttpProductInfoHeaderValue[]) |
Reemplaza todos los elementos HttpProductInfoHeaderValue de la colección por los elementos HttpProductInfoHeaderValue especificados. |
SetAt(UInt32, HttpProductInfoHeaderValue) |
Establece HttpProductInfoHeaderValue en el índice especificado de la colección. |
ToString() |
Devuelve una cadena que representa el objeto HttpProductInfoHeaderValueCollection actual. |
TryParseAdd(String) |
Intenta analizar y agregar el elemento especificado a httpProductInfoHeaderValueCollection. |