HttpRequestHeaderCollection.TransferEncoding 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 HttpTransferCodingHeaderValueCollection von HttpTransferCodingHeaderValue-Objekten ab, die den Wert eines Transfer-Encoding-HTTP-Headers für eine HTTP-Anforderung darstellen.
public:
property HttpTransferCodingHeaderValueCollection ^ TransferEncoding { HttpTransferCodingHeaderValueCollection ^ get(); };HttpTransferCodingHeaderValueCollection TransferEncoding();public HttpTransferCodingHeaderValueCollection TransferEncoding { get; }var httpTransferCodingHeaderValueCollection = httpRequestHeaderCollection.transferEncoding;Public ReadOnly Property TransferEncoding As HttpTransferCodingHeaderValueCollectionEigenschaftswert
Die Auflistung von HttpTransferCodingHeaderValue-Objekten , die den Wert eines Transfer-Encoding-HTTP-Headers für eine HTTP-Anforderung darstellen. Eine leere Auflistung bedeutet, dass der Header nicht vorhanden ist.
Hinweise
Der einzige von HttpClient unterstützte Übertragungscodierungswert ist chunked, obwohl die HttpTransferCodingHeaderValueCollection von HttpTransferCodingHeaderValue-Objekten das Festlegen anderer Werte unterstützt.
Es ist nicht erforderlich, den Wert der Übertragungscodierung manuell auf "chunked" festzulegen, wenn die HttpRequestMessage als ein gesendet wird, ohne dass die Inhaltslänge angegeben oder mithilfe der -Methode auf HttpClient oder einer der Methoden für die HTTP-Inhaltsklassen angegeben oder verfügbar ist.
Der folgende Beispielcode zeigt eine Methode zum Festlegen des Transfer-Encoding-Headers für ein HttpRequestMessage-Objekt mithilfe der TransferEncoding-Eigenschaft für das HttpRequestHeaderCollection-Objekt .
void DemoTransferEncoding(HttpRequestMessage m) {
var h = m.Headers;
uiLog.Text += "\nTRANSFERENCODING HEADER\n";
// Transfer-Encoding: chunked
var okTryParseAdd = h.TransferEncoding.TryParseAdd("chunked");
okTryParseAdd = h.TransferEncoding.TryParseAdd("mini; a=b; c=d; e=f");
h.TransferEncoding.Add(new HttpTransferCodingHeaderValue("cab"));
h.TransferEncoding.TryParseAdd("newtype, othernewtype");
// TransferEncoding is a HttpTransferCodingHeaderValueCollection
// A collection of HttpTransferCodingHeaderValue
// HttpTransferCodingHeaderValue has three items:
// Value (string); for example, "compress"
// Parameter (IList<HttpNameValueHeaderValue>)
//
foreach (var item in h.TransferEncoding) {
// item has: Value (string), Parameter IList<HttpNameValueHeaderValue>
var parameterString = "";
foreach (var parameter in item.Parameters) {
parameterString += string.Format("[{0}={1}] ", parameter.Name, parameter.Value);
}
if (parameterString == "") {
parameterString = "(no parameters)";
}
uiLog.Text += string.Format("Value: {0} Parameters: {1} ToString: {2}\n", item.Value, parameterString, item.ToString());
}
uiLog.Text += string.Format("TransferEncoding: ToString: {0}\n\n", h.TransferEncoding.ToString());
}