HttpRequestHeaderCollection.UserAgent Propiedad
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í.
Obtiene la httpProductInfoHeaderValueCollection de los objetos HttpProductInfoHeaderValue que representan el valor de un encabezado HTTP del agente de usuario en una solicitud HTTP.
public:
property HttpProductInfoHeaderValueCollection ^ UserAgent { HttpProductInfoHeaderValueCollection ^ get(); };HttpProductInfoHeaderValueCollection UserAgent();public HttpProductInfoHeaderValueCollection UserAgent { get; }var httpProductInfoHeaderValueCollection = httpRequestHeaderCollection.userAgent;Public ReadOnly Property UserAgent As HttpProductInfoHeaderValueCollectionValor de propiedad
Colección de objetos HttpProductInfoHeaderValue que representan el valor de un encabezado HTTP user-agent en una solicitud HTTP. Una colección vacía significa que el encabezado no está presente.
Comentarios
En el código de ejemplo siguiente se muestra un método para establecer el encabezado User-Agent en un objeto HttpRequestMessage mediante la propiedad UserAgent en el objeto HttpRequestHeaderCollection .
void DemoUserAgent(HttpRequestMessage m) {
var h = m.Headers;
uiLog.Text += "\nUSERAGENT HEADER\n";
// User-Agent: CERN-LineMode/2.15 libwww/2.17b3
// User-Agent: Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 6.1; WOW64; Trident/5.0; SLCC2; .NET CLR 2.0.50727; .NET CLR 3.5.30729; .NET CLR 3.0.30729; Media Center PC 6.0; Zune 4.0; InfoPath.3; MS-RTC LM 8; .NET4.0C; .NET4.0E)
var ok = h.UserAgent.TryParseAdd("ie");
ok = h.UserAgent.TryParseAdd("Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 6.1; WOW64; Trident/5.0; SLCC2; .NET CLR 2.0.50727; .NET CLR 3.5.30729; .NET CLR 3.0.30729; Media Center PC 6.0; Zune 4.0; InfoPath.3; MS-RTC LM 8; .NET4.0C; .NET4.0E)");
ok = h.UserAgent.TryParseAdd("CERN-LineMode/2.15 libwww/2.17b3");
h.UserAgent.Add (new HttpProductInfoHeaderValue ("productComment"));
h.UserAgent.Add(new HttpProductInfoHeaderValue("Mozilla", "1.0"));
// UserAgent is a HttpProductInfoHeaderValueCollection
// A collection of HttpProductInfoHeaderValue
// HttpProductInfoHeaderValue has two items:
// Product (string)
// Comment (string)
//
// According to the RFC, each "item" is EITHER a product OR a comment, and a product is EITHER product or product/version
foreach (var item in h.UserAgent) {
// item has: Value (string), Parameter IList<HttpNameValueHeaderValue>
uiLog.Text += string.Format("Product: {0} Comment: {1} ToString: {2}\n", item.Product, item.Comment, item.ToString());
}
uiLog.Text += string.Format("UserAgent: ToString: {0}\n\n", h.UserAgent.ToString());
}