HttpRequestHeaderCollection.TransferEncoding Eigenschaft

Definition

Namespace:

Windows.Web.Http.Headers

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 HttpTransferCodingHeaderValueCollection

Eigenschaftswert

HttpTransferCodingHeaderValueCollection

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());
}

Weitere Informationen

• HttpRequestMessage
• Headers
• HttpTransferCodingHeaderValue
• HttpTransferCodingHeaderValueCollection