HttpRequestHeaderCollection.UserAgent Proprietà

Definizione

Spazio dei nomi:

Windows.Web.Http.Headers

Ottiene l'oggetto HttpProductInfoHeaderValueCollection degli oggetti HttpProductInfoHeaderValue che rappresentano il valore di un'intestazione HTTP dell'agente utente in una richiesta HTTP.

public:
 property HttpProductInfoHeaderValueCollection ^ UserAgent { HttpProductInfoHeaderValueCollection ^ get(); };

HttpProductInfoHeaderValueCollection UserAgent();

public HttpProductInfoHeaderValueCollection UserAgent { get; }

var httpProductInfoHeaderValueCollection = httpRequestHeaderCollection.userAgent;

Public ReadOnly Property UserAgent As HttpProductInfoHeaderValueCollection

Valore della proprietà

HttpProductInfoHeaderValueCollection

Raccolta di oggetti HttpProductInfoHeaderValue che rappresentano il valore di un'intestazione HTTP dell'agente utente in una richiesta HTTP. Una raccolta vuota significa che l'intestazione è assente.

Commenti

Il codice di esempio seguente mostra un metodo per impostare l'intestazione User-Agent su un oggetto HttpRequestMessage usando la proprietà UserAgent nell'oggetto 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());
}

Vedi anche

• HttpProductInfoHeaderValue
• HttpProductInfoHeaderValueCollection
• HttpRequestMessage
• Headers