HttpRequestHeaderCollection.UserAgent Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient le HttpProductInfoHeaderValueCollection des objets HttpProductInfoHeaderValue qui représentent la valeur d’un en-tête HTTP User-Agent sur une requête HTTP.
public:
property HttpProductInfoHeaderValueCollection ^ UserAgent { HttpProductInfoHeaderValueCollection ^ get(); };HttpProductInfoHeaderValueCollection UserAgent();public HttpProductInfoHeaderValueCollection UserAgent { get; }var httpProductInfoHeaderValueCollection = httpRequestHeaderCollection.userAgent;Public ReadOnly Property UserAgent As HttpProductInfoHeaderValueCollectionValeur de propriété
Collection d’objets HttpProductInfoHeaderValue qui représentent la valeur d’un en-tête HTTP User-Agent sur une requête HTTP. Une collection vide signifie que l’en-tête est absent.
Remarques
L’exemple de code suivant montre une méthode permettant de définir l’en-tête User-Agent sur un objet HttpRequestMessage à l’aide de la propriété UserAgent sur l’objet 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());
}