HttpContentHeaderCollection HttpContentHeaderCollection HttpContentHeaderCollection HttpContentHeaderCollection Class

Initializes a new instance of the HttpContentHeaderCollection class.

public : HttpContentHeaderCollection()public HttpContentHeaderCollection()Public Sub New()// You can use this method in JavaScript.

Remarks

An HttpContentHeaderCollection object is returned by the property on HttpBufferContent, HttpFormUrlEncodedContent, HttpMultipartContent, HttpMultipartFormDataContent, HttpStreamContent, and HttpStringContent, classes and the IHttpContent interface.

Gets or sets the HttpContentDispositionHeaderValue object that represents the value of an HTTP Content-Disposition header on the HTTP content.

public : HttpContentDispositionHeaderValue ContentDisposition { get; set; }public HttpContentDispositionHeaderValue ContentDisposition { get; set; }Public ReadWrite Property ContentDisposition As HttpContentDispositionHeaderValue// You can use this property in JavaScript.

Remarks

The following sample code shows a method to get or set the Content-Disposition header value on HTTP content using the ContentDisposition property on the HttpContentHeaderCollection object.

    // Content-Disposition header
    // HttpContentDispositionHeaderValue
    void DemoContentDisposition(IHttpContent content) {
        var h = content.Headers;

        HttpContentDispositionHeaderValue value;
        bool ok = HttpContentDispositionHeaderValue.TryParse("attachment; filename=\"myfile.txt\"; myparam=myvalue", out value);
        h.ContentDisposition = value;

        h.ContentDisposition = HttpContentDispositionHeaderValue.Parse("attachment; filename=\"myfile.txt\"; myparam=myvalue");
        var header = h.ContentDisposition;

        uiLog.Text += "\nCONTENT DISPOSITION HEADER\n";
        // Content-Disposition: attachment; filename="fname.ext"

        // ContentDisposition is a HttpContentDispositionHeaderValue and contains:
        // DispositionType, FileName, FileNameStar, Name: all strings
        // Size: nullable long
        // Parameters: IList<HttpNameValueHeaderValue> 
        var parameterString = "";
        foreach (var parameter in header.Parameters) {
            parameterString += string.Format("[{0}={1}] ", parameter.Name, parameter.Value);
        }
        if (parameterString == "") {
            parameterString = "(no parameters)";
        }

        uiLog.Text += string.Format("ContentDisposition: DispositionType: {0} FileName: {1} FileNameStar: {2} Name: {3} Parameters: {4} Size: {5} ToString: {6}\n\n", 
        header.DispositionType, header.FileName, header.FileNameStar, header.Name, parameterString, header.Size, header.ToString());
    }

See Also

HttpContentDispositionHeaderValueHttpContentDispositionHeaderValueHttpContentDispositionHeaderValueHttpContentDispositionHeaderValue

Gets the HttpContentCodingHeaderValueCollection of HttpContentCodingHeaderValue objects that represent the value of an HTTP Content-Encoding header on the HTTP content.

public : HttpContentCodingHeaderValueCollection ContentEncoding { get; }public HttpContentCodingHeaderValueCollection ContentEncoding { get; }Public ReadOnly Property ContentEncoding As HttpContentCodingHeaderValueCollection// You can use this property in JavaScript.

Remarks

The following sample code shows a method to get or set the Content-Encoding header value on HTTP content using the ContentEncoding property on the HttpContentHeaderCollection object.

    // Content-Encoding header
    // HttpContentCodingHeaderValueCollection
    // HttpContentCodingHeaderValue [has ContentCoding, a string]
    void DemoContentEncoding(IHttpContent content) {
        var h = content.Headers;

        h.ContentEncoding.TryParseAdd("gzip");
        h.ContentEncoding.TryParseAdd("cab, compress");
        h.ContentEncoding.Add(new HttpContentCodingHeaderValue("myencoding"));

        var header = h.ContentEncoding;
        uiLog.Text += "\nCONTENT ENCODING HEADER\n";
        foreach (var item in header) {
            uiLog.Text += string.Format("ContentCoding: {0}  ToString: {1}\n", item.ContentCoding, item.ToString());
        }
        uiLog.Text += string.Format("ContentEncoding: ToString: {0}\n\n", header.ToString());
    }

See Also

HttpContentCodingHeaderValueCollectionHttpContentCodingHeaderValueCollectionHttpContentCodingHeaderValueCollectionHttpContentCodingHeaderValueCollection

Gets the HttpLanguageHeaderValueCollection of objects that represent the value of an HTTP Content-Language header on the HTTP content.

public : HttpLanguageHeaderValueCollection ContentLanguage { get; }public HttpLanguageHeaderValueCollection ContentLanguage { get; }Public ReadOnly Property ContentLanguage As HttpLanguageHeaderValueCollection// You can use this property in JavaScript.

Remarks

The following sample code shows a method to get or set the Content-Language header value on HTTP content using the ContentLanguage property on the HttpContentHeaderCollection object.

    // Content-Language header
    // HttpLanguageHeaderValueCollection (of Windows.Globalization.Language)
    void DemoContentLanguage(IHttpContent content) {
        var h = content.Headers;

        h.ContentLanguage.TryParseAdd("en-us");
        h.ContentLanguage.TryParseAdd("ru-ru, ru-us");
        h.ContentLanguage.Add(new Windows.Globalization.Language("ko-ko"));

        var header = h.ContentLanguage;
        uiLog.Text += "\nCONTENT LANGUAGE HEADER\n";
        foreach (var item in header) {
            uiLog.Text += string.Format("DisplayName: {0} ToString: {1}\n", item.DisplayName, item.ToString());
        }
        uiLog.Text += string.Format("ContentLanguage: ToString: {0}\n\n", header.ToString());
    }

See Also

HttpLanguageHeaderValueCollectionHttpLanguageHeaderValueCollectionHttpLanguageHeaderValueCollectionHttpLanguageHeaderValueCollection

Gets or sets the value of the HTTP Content-Length header on the HTTP content.

public : IReference<ulong> ContentLength { get; set; }public Nullable<ulong> ContentLength { get; set; }Public ReadWrite Property ContentLength As Nullable<ulong>// You can use this property in JavaScript.

Remarks

The following sample code shows a method to get or set the Content-Length header on HTTP content using the ContentLength property on the HttpContentHeaderCollection object.

    // Content-Length header
    // nullable ulong
    void DemoContentLength(IHttpContent content) {
        var h = content.Headers;

        h.ContentLength = 313;

        var header = h.ContentLength;
        uiLog.Text += "\nCONTENT LENGTH HEADER\n";

        uiLog.Text += string.Format("ContentLength: ToString: {0}\n\n", header.ToString());
    }

Gets or sets the value of the HTTP Content-Location header on the HTTP content.

public : Uri ContentLocation { get; set; }public Uri ContentLocation { get; set; }Public ReadWrite Property ContentLocation As Uri// You can use this property in JavaScript.

Remarks

The following sample code shows a method to get or set the Content-Location header value on HTTP content using the ContentLocation property on the HttpContentHeaderCollection object.

    // Content-Location header
    // Uri
    void DemoContentLocation(IHttpContent content) {
        var h = content.Headers;

        h.ContentLocation = new Uri("http://example.com/");

        var header = h.ContentLocation;
        uiLog.Text += "\nCONTENT LOCATION HEADER\n";

        uiLog.Text += string.Format("ContentLocation: ToString: {0}\n\n", header.ToString());
    }

See Also

UriUriUriUri

Gets or sets the value of an HTTP Content-MD5 header on the HTTP content.

public : IBuffer ContentMD5 { get; set; }public IBuffer ContentMD5 { get; set; }Public ReadWrite Property ContentMD5 As IBuffer// You can use this property in JavaScript.

Remarks

The following sample code shows a method to get or set the Content-MD5 header value on HTTP content using the ContentMD5 property on the HttpContentHeaderCollection object.

    // Content-MD5 header
    // IBuffer
    void DemoContentMD5(IHttpContent content) {
        var h = content.Headers;

        var str = "This is my content string";
        var alg = Windows.Security.Cryptography.Core.HashAlgorithmProvider.OpenAlgorithm("MD5");
        var buff = Windows.Security.Cryptography.CryptographicBuffer.ConvertStringToBinary(str, Windows.Security.Cryptography.BinaryStringEncoding.Utf8);
        var hashed = alg.HashData(buff);
        var res = Windows.Security.Cryptography.CryptographicBuffer.EncodeToHexString(hashed);
        h.ContentMD5 = hashed;

        var header = h.ContentMD5;
        uiLog.Text += "\nCONTENT MD5 HEADER\n";

        uiLog.Text += string.Format("ContentMD5: ToString: {0}\n\n", header.ToString());
        uiLog.Text += string.Format("ContentMD5: base64: {0} hex: {1}\n\n", Convert.ToBase64String(h.ContentMD5.ToArray()), res);
    }

Gets or sets the HttpContentRangeHeaderValue object that represent the value of an HTTP Content-Range header on the HTTP content.

public : HttpContentRangeHeaderValue ContentRange { get; set; }public HttpContentRangeHeaderValue ContentRange { get; set; }Public ReadWrite Property ContentRange As HttpContentRangeHeaderValue// You can use this property in JavaScript.

Remarks

The following sample code shows a method to get or set the Content-Range header value on HTTP content using the ContentRange property on the HttpContentHeaderCollection object.

    // Content-Range header
    // HttpContentRangeHeaderValue (Unit=string, FirstBytePosition, LastBytePosition, Length) all nullable ulong
    //
    void DemoContentRange(IHttpContent content) {
        var h = content.Headers;
        h.ContentRange = new HttpContentRangeHeaderValue (10, 20, 333);

        var header = h.ContentRange;
        uiLog.Text += "\nCONTENT RANGE HEADER\n";

        uiLog.Text += string.Format("ContentRange: Unit: {0} FirstBytePosition: {1} LastBytePosition: {2} Length: {3} ToString: {4}\n\n", header.Unit, header.FirstBytePosition, header.LastBytePosition, header.Length, header.ToString());
    }

See Also

HttpContentRangeHeaderValueHttpContentRangeHeaderValueHttpContentRangeHeaderValueHttpContentRangeHeaderValue

Gets or sets the HttpMediaTypeHeaderValue object that represent the value of an HTTP Content-Type header on the HTTP content.

public : HttpMediaTypeHeaderValue ContentType { get; set; }public HttpMediaTypeHeaderValue ContentType { get; set; }Public ReadWrite Property ContentType As HttpMediaTypeHeaderValue// You can use this property in JavaScript.

Remarks

The ContentType property represents the Content-Type header value on HTTP content. The Content-Type header is the MIME type of the content.

The following sample code shows a method to get or set the Content-Type header value on HTTP content using the ContentType property on the HttpContentHeaderCollection object.

    // Content-Type header
    // HttpMediaTypeHeaderValue (MediaType, Charset are strings, Parameters is an IList<HttpNameValueHeaderValue>)
    //
    void DemoContentType(IHttpContent content) {
        var h = content.Headers;
        h.ContentType = new HttpMediaTypeHeaderValue("myMediaType");

        var header = h.ContentType;
        uiLog.Text += "\nCONTENT TYPE HEADER\n";

        // Parameters is an IList<HttpNameValueHeaderValue> of Name/Value strings
        var parameterString = "";
        foreach (var parameter in header.Parameters) {
                parameterString += string.Format("[{0}={1}] ", parameter.Name, parameter.Value);
        }
        if (parameterString == "") {
                parameterString = "(no parameters)";
        }

        uiLog.Text += string.Format("Content-Type: MediaType: {0} CharSet: {1} Parameters: {2} ToString: {3}\n", header.MediaType, header.CharSet, parameterString, header.ToString());
    }

See Also

HttpMediaTypeHeaderValueHttpMediaTypeHeaderValueHttpMediaTypeHeaderValueHttpMediaTypeHeaderValue

Gets or sets the DateTime object that represents the value of an HTTP Expires header on the HTTP content.

public : IReference<DateTime> Expires { get; set; }public Nullable<DateTimeOffset> Expires { get; set; }Public ReadWrite Property Expires As Nullable<DateTimeOffset>// You can use this property in JavaScript.

Remarks

The Expires property represents the value of the Expires header on HTTP content. The Expires header is the date and time after which the HTTP content is considered outdated.

Javascript and .NET languages do not use the DateTime object directly. In Javascript a DateTime is projected as a object, and in .NET it is projected as a System.DateTimeOffset. Each language transparently handles the conversion to the granularity and date ranges for the respective language.

In C++, a value has the same granularity as a and supports the date ranges required by Javascript and .NET.

For more detailed information, see the Windows.Foundation.DateTime structure.

The following sample code shows a method to get or set the Expires header value on HTTP content using the Expires property on the HttpContentHeaderCollection object.

    // Expires header
    // nullable DateTimeOffset
    //
    void DemoExpires(IHttpContent content) {
        var h = content.Headers;
        h.Expires = DateTimeOffset.Now;

        var header = h.Expires;
        uiLog.Text += "\nEXPIRES HEADER\n";
        uiLog.Text += String.Format ("Expires: {0}\n", header.ToString());
    }

Gets or sets the element with the specified key.

This member is not implemented in C++TValue this[TKey key] { get; set; }Property Item(key As TKey) As TValueTValue this[TKey key] { get; set; }

Gets an System.Collections.Generic.ICollection`1 containing the keys of the System.Collections.Generic.IDictionary`2.

This member is not implemented in C++ICollection<TKey> Keys { get; }ReadOnly Property Keys As ICollection(Of TKey)ICollection<TKey> Keys { get; }

Gets or sets the DateTime object that represents the value of an HTTP Last-Modified header on the HTTP content.

public : IReference<DateTime> LastModified { get; set; }public Nullable<DateTimeOffset> LastModified { get; set; }Public ReadWrite Property LastModified As Nullable<DateTimeOffset>// You can use this property in JavaScript.

Remarks

The LastModified property represents the Last-Modified header on HTTP content. The Last-Modified header is the date and time that the HTTP content was last modified.

Javascript and .NET languages do not use the DateTime object directly. In Javascript a DateTime is projected as a object, and in .NET it is projected as a System.DateTimeOffset. Each language transparently handles the conversion to the granularity and date ranges for the respective language.

In C++, a value has the same granularity as a and supports the date ranges required by Javascript and .NET.

For more detailed information, see the Windows.Foundation.DateTime structure.

The following sample code shows a method to get or set the Expires header value on HTTP content using the LastModified property on the HttpContentHeaderCollection object.

    // Last-Modified header
    // nullable DateTimeOffset
    //
    void DemoLastModified(IHttpContent content) {
        var h = content.Headers;
        h.LastModified = DateTimeOffset.Now;

        var header = h.LastModified;
        uiLog.Text += "\nLAST MODIFIED HEADER\n";
        uiLog.Text += String.Format("LastModified: {0}\n", header.ToString());
    }

Gets the number of objects in the HttpContentHeaderCollection.

public : unsigned int Size { get; }This member is not implemented in C#This member is not implemented in VB.Net// You can use this property in JavaScript.

Remarks

The Size property returns the true number of items.

If you are programming using C# or Microsoft Visual Basic, the equivalent method is Count.

Gets an System.Collections.Generic.ICollection`1 containing the values in the System.Collections.Generic.IDictionary`2.

This member is not implemented in C++ICollection<TValue> Values { get; }ReadOnly Property Values As ICollection(Of TValue)ICollection<TValue> Values { get; }

Adds an element with the provided key and value to the System.Collections.Generic.IDictionary`2.

This member is not implemented in C++void Add(TKey key, TValue value)Sub Add(key As TKey, value As TValue)void Add(TKey key, TValue value)

Adds a new item to the end of the HttpContentHeaderCollection.

public : void Append(PlatForm::String name, PlatForm::String value)public void Append(String name, String value)Public Function Append(name As String, value As String) As void// You can use this method in JavaScript.

Removes all objects from the HttpContentHeaderCollection.

public : void Clear()This member is not implemented in C#This member is not implemented in VB.Net// You can use this method in JavaScript.

Determines whether the System.Collections.Generic.IDictionary`2 contains an element with the specified key.

This member is not implemented in C++bool ContainsKey(TKey key)Function ContainsKey(key As TKey) As Booleanbool ContainsKey(TKey key)

Retrieves an iterator to the first item in the HttpContentHeaderCollection.

public : IIterator<IKeyValuePair<PlatForm::String, PlatForm::String>> First()This member is not implemented in C#This member is not implemented in VB.Net// You can use this method in JavaScript.

Returns an enumerator that iterates through the collection.

This member is not implemented in C++IEnumerator<T> GetEnumerator()Function GetEnumerator As IEnumerator(Of T)IEnumerator<T> GetEnumerator()

Returns an immutable view of the HttpContentHeaderCollection.

public : IMapView<PlatForm::String, PlatForm::String> GetView()This member is not implemented in C#This member is not implemented in VB.Net// You can use this method in JavaScript.

Remarks

When programming with .NET, this method is hidden.

Determines whether the HttpContentHeaderCollection contains the specified key.

public : PlatForm::Boolean HasKey(PlatForm::String key)This member is not implemented in C#This member is not implemented in VB.Net// You can use this method in JavaScript.

Remarks

When programming with .NET, this method is hidden and developers should use ContainsKey.

Inserts or replaces an item in the HttpContentHeaderCollection with the specified key and value.

public : PlatForm::Boolean Insert(PlatForm::String key, PlatForm::String value)This member is not implemented in C#This member is not implemented in VB.Net// You can use this method in JavaScript.

Remarks

When programming with .NET, this method is hidden and developers should use the Add methods.

Finds an item in the HttpContentHeaderCollection if it exists.

public : PlatForm::String Lookup(PlatForm::String key)This member is not implemented in C#This member is not implemented in VB.Net// You can use this method in JavaScript.

Remarks

Use the HasKey method to determine whether the key exists in the HttpContentHeaderCollection.

When programming with .NET, this method is hidden and developers should use the Item indexer.

See Also

HasKey(String)HasKey(String)HasKey(String)HasKey(String)

Removes the element with the specified key from the System.Collections.Generic.IDictionary`2.

This member is not implemented in C++bool Remove(TKey key)Function Remove(key As TKey) As Booleanbool Remove(TKey key)

Removes a specific object from the HttpContentHeaderCollection.

public : void Remove(PlatForm::String key)This member is not implemented in C#This member is not implemented in VB.Net// You can use this method in JavaScript.

Returns a string that represents the current HttpContentHeaderCollection object.

public : PlatForm::String ToString()public string ToString()Public Function ToString() As string// You can use this method in JavaScript.

Try to append the specified item to the HttpContentHeaderCollection without validation.

public : PlatForm::Boolean TryAppendWithoutValidation(PlatForm::String name, PlatForm::String value)public bool TryAppendWithoutValidation(String name, String value)Public Function TryAppendWithoutValidation(name As String, value As String) As bool// You can use this method in JavaScript.

Remarks

The TryAppendWithoutValidation method is available when you need to work with an HTTP header on HTTP content that doesn't have a strongly-typed class for the HTTP header. If there is a strongly-typed implementation of the HTTP header, then the methods and properties on the strongly-typed class should be used instead of the TryAppendWithoutValidation method.

Gets the value associated with the specified key.

This member is not implemented in C++bool TryGetValue(TKey key, out TValue value)Function TryGetValue(key As TKey, ByRef value As TValue) As Booleanbool TryGetValue(TKey key, out TValue value)