HttpRequestHeaderCollection.UserAgent Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft die HttpProductInfoHeaderValueCollection von HttpProductInfoHeaderValue-Objekten ab , die den Wert eines User-Agent-HTTP-Headers für eine HTTP-Anforderung darstellen.
public:
property HttpProductInfoHeaderValueCollection ^ UserAgent { HttpProductInfoHeaderValueCollection ^ get(); };HttpProductInfoHeaderValueCollection UserAgent();public HttpProductInfoHeaderValueCollection UserAgent { get; }var httpProductInfoHeaderValueCollection = httpRequestHeaderCollection.userAgent;Public ReadOnly Property UserAgent As HttpProductInfoHeaderValueCollectionEigenschaftswert
Die Auflistung von HttpProductInfoHeaderValue-Objekten , die den Wert eines User-Agent-HTTP-Headers für eine HTTP-Anforderung darstellen. Eine leere Auflistung bedeutet, dass der Header nicht vorhanden ist.
Hinweise
Der folgende Beispielcode zeigt eine Methode zum Festlegen des User-Agent-Headers für ein HttpRequestMessage-Objekt mithilfe der UserAgent-Eigenschaft für das HttpRequestHeaderCollection-Objekt .
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());
}