HttpRequestHeaderCollection.TransferEncoding Propriété

Définition

Espace de noms:

Windows.Web.Http.Headers

Obtient le HttpTransferCodingHeaderValueCollection des objets HttpTransferCodingHeaderValue qui représentent la valeur d’un en-tête HTTP Transfer-Encoding sur une requête HTTP.

public:
 property HttpTransferCodingHeaderValueCollection ^ TransferEncoding { HttpTransferCodingHeaderValueCollection ^ get(); };

HttpTransferCodingHeaderValueCollection TransferEncoding();

public HttpTransferCodingHeaderValueCollection TransferEncoding { get; }

var httpTransferCodingHeaderValueCollection = httpRequestHeaderCollection.transferEncoding;

Public ReadOnly Property TransferEncoding As HttpTransferCodingHeaderValueCollection

Valeur de propriété

HttpTransferCodingHeaderValueCollection

Collection d’objets HttpTransferCodingHeaderValue qui représentent la valeur d’un en-tête HTTP Transfer-Encoding sur une requête HTTP. Une collection vide signifie que l’en-tête est absent.

Remarques

La seule valeur d’encodage de transfert prise en charge par HttpClient est segmentée, même si les objets HttpTransferCodingHeaderValueCollection de HttpTransferCodingHeaderValue prennent en charge la définition d’autres valeurs.

Il n’est pas nécessaire de définir manuellement la valeur d’encodage de transfert sur segmentée si httpRequestMessage est envoyé en tant que sans longueur de contenu spécifiée ou disponible à l’aide de la méthode sur HttpClient ou de l’une des méthodes sur les classes de contenu HTTP.

L’exemple de code suivant montre une méthode pour définir l’en-tête Transfer-Encoding sur un objet HttpRequestMessage à l’aide de la propriété TransferEncoding sur l’objet HttpRequestHeaderCollection .

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

Voir aussi

• HttpRequestMessage
• Headers
• HttpTransferCodingHeaderValue
• HttpTransferCodingHeaderValueCollection