-api-id | -api-type |
---|---|
T:Windows.Web.Http.Headers.HttpContentCodingWithQualityHeaderValueCollection |
winrt class |
Represents the value of the Accept-Encoding HTTP header on an HTTP request.
The HttpContentCodingWithQualityHeaderValueCollection class represents the value of the Accept-Encoding HTTP header on an HTTP request.
The HttpContentCodingWithQualityHeaderValueCollection provides a collection container for instances of the HttpContentCodingWithQualityHeaderValue class used for accept encoding information in the Accept-Encoding HTTP header.
The AcceptEncoding property on the HttpRequestHeaderCollection returns an HttpContentCodingWithQualityHeaderValueCollection object. This is the method used to construct an HttpContentCodingWithQualityHeaderValueCollection object.
For JavaScript, HttpContentCodingWithQualityHeaderValueCollection has the members shown in the member lists. In addition, HttpContentCodingWithQualityHeaderValueCollection supports members of Array.prototype and using an index to access items.
You can iterate through an HttpContentCodingWithQualityHeaderValueCollection object in C# or Microsoft Visual Basic. In many cases, such as using foreach syntax, the compiler does this casting for you and you won't need to cast to IEnumerable<HttpContentCodingWithQualityHeaderValue>
explicitly. If you do need to cast explicitly, for example if you want to call GetEnumerator, cast the collection object to IEnumerable<T> with an HttpContentCodingWithQualityHeaderValue constraint.
The following sample code shows a method to get and set the Accept-Encoding HTTP header on an HttpRequestMessage object using the properties and methods on the HttpContentCodingWithQualityHeaderValueCollection and HttpContentCodingWithQualityHeaderValue classes.
using Windows.Web.Http;
using Windows.Web.Http.Headers;
public void DemonstrateHeaderRequestAcceptEncoding()
{
var request = new HttpRequestMessage();
bool parsedOk = false;
// Set the header with a string.
parsedOk = request.Headers.AcceptEncoding.TryParseAdd("compress");
parsedOk = request.Headers.AcceptEncoding.TryParseAdd("gzip;q=1.0");
// Set the header with a strong type.
request.Headers.AcceptEncoding.Add(new HttpContentCodingWithQualityHeaderValue("*", 0));
// Get the strong type out
foreach (var value in request.Headers.AcceptEncoding)
{
System.Diagnostics.Debug.WriteLine("One of the AcceptEncoding values: {0}={1}", value.ContentCoding, value.Quality);
}
// The ToString() is useful for diagnostics, too.
System.Diagnostics.Debug.WriteLine("The AcceptEncoding ToString() results: {0}", request.Headers.AcceptEncoding.ToString());
}
AcceptEncoding, HttpContentCodingWithQualityHeaderValue, HttpRequestHeaderCollection, HttpRequestMessage, IIterable(HttpContentCodingWithQualityHeaderValue), IStringable, IVector(HttpContentCodingWithQualityHeaderValue)