HttpClient.DefaultRequestHeaders Eigenschaft

Definition

Namespace:

Windows.Web.Http

Ruft eine Auflistung von Headern ab, die mit jeder Anforderung gesendet werden sollen. Programmieranleitungen für die HttpClient-Klasse und Codebeispiele finden Sie im Konzeptthema HttpClient .

public:
 property HttpRequestHeaderCollection ^ DefaultRequestHeaders { HttpRequestHeaderCollection ^ get(); };

HttpRequestHeaderCollection DefaultRequestHeaders();

public HttpRequestHeaderCollection DefaultRequestHeaders { get; }

var httpRequestHeaderCollection = httpClient.defaultRequestHeaders;

Public ReadOnly Property DefaultRequestHeaders As HttpRequestHeaderCollection

Eigenschaftswert

HttpRequestHeaderCollection

Die Header, die mit jeder Anforderung gesendet werden sollen.

Hinweise

Die DefaultRequestHeaders-Eigenschaft gibt ein HttpRequestHeaderCollection-Objekt zurück, mit dem die spezifischen Header auf dem HttpClient-instance abgerufen oder festgelegt werden können. HTTP-Header, die für diese Eigenschaft festgelegt sind, werden für alle Anforderungsnachrichten gesendet, die auf diesem HttpClient-instance gesendet werden, und müssen nicht für jede HttpRequestMessage-instance festgelegt werden.

Die Headers-Eigenschaft für das HttpRequestMessage-Objekt gibt ein HttpRequestHeaderCollection-Objekt zurück, mit dem die spezifischen Header für eine bestimmte HTTP-Anforderung abgerufen oder festgelegt werden können.

Die DefaultRequestHeaders-Eigenschaft stellt die Header dar, die ein App-Entwickler festlegen kann, nicht alle Header, die möglicherweise mit der Anforderung gesendet werden. Der HttpBaseProtocolFilter fügt einige zusätzliche Header hinzu.

Warnung

In Versionen vor Windows 10 führte das Festlegen bestimmter Header auf NULL dazu, dass ein leerer Headerwert festgelegt wurde, was zu einem unerwarteten Fehler bei nachfolgenden Aufrufen von GetAsync führte. Ab Windows 10 führt das Festlegen eines der folgenden Header auf NULL dazu, dass sie vollständig aus der Anforderung entfernt werden, sodass die restlichen Header gültig sind.

• Authorization
• Datum
• From
• Host
• If-Modified-Since
• If-Unmodified-Since
• Max-Forwards
• Proxy-Authorization
• Referer

Wenn Sie für Versionen vor Windows 10 schreiben, legen Sie diese Headerwerte nicht auf NULL fest.

Weitere Informationen

• HttpClient