HttpCredentialsHeaderValue Clase

Definición

Espacio de nombres:

Windows.Web.Http.Headers

Representa el valor del encabezado HTTP Authorization o Proxy-Authorization en una solicitud HTTP.

public ref class HttpCredentialsHeaderValue sealed : IStringable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Web.Http.Headers.IHttpCredentialsHeaderValueFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class HttpCredentialsHeaderValue final : IStringable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Web.Http.Headers.IHttpCredentialsHeaderValueFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class HttpCredentialsHeaderValue : IStringable

function HttpCredentialsHeaderValue(scheme, token)

Public NotInheritable Class HttpCredentialsHeaderValue
Implements IStringable

Herencia

Object Platform::Object IInspectable HttpCredentialsHeaderValue

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementaciones

IStringable

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

En el código de ejemplo siguiente se muestra un método para obtener y establecer el encabezado HTTP de autorización en un objeto HttpRequestMessage mediante las propiedades y métodos de la clase HttpCredentialsHeaderValue.

using System;
using Windows.Web.Http;
using Windows.Web.Http.Headers;

        public void DemonstrateHeaderRequestAuthorization() {
            var request = new HttpRequestMessage();

            // Set the header with a strong type.
            string username = "user";
            string password = "password";
            var buffer = Windows.Security.Cryptography.CryptographicBuffer.ConvertStringToBinary (username + ":" + password, Windows.Security.Cryptography.BinaryStringEncoding.Utf16LE);
            string base64token = Windows.Security.Cryptography.CryptographicBuffer.EncodeToBase64String(buffer);
            request.Headers.Authorization = new HttpCredentialsHeaderValue("Basic", base64token);


            // Get the strong type out
            System.Diagnostics.Debug.WriteLine("One of the Authorization values: {0}={1}", 
                request.Headers.Authorization.Scheme,
                request.Headers.Authorization.Token);

            // The ToString() is useful for diagnostics, too.
            System.Diagnostics.Debug.WriteLine("The Authorization ToString() results: {0}", request.Headers.Authorization.ToString());
        }

En el código de ejemplo siguiente se muestra un método para obtener y establecer el encabezado HTTP proxy-Authorization en un objeto HttpRequestMessage mediante las propiedades y métodos de la clase HttpCredentialsHeaderValue.

using System;
using Windows.Web.Http;
using Windows.Web.Http.Headers;

        public void DemonstrateHeaderRequestProxyAuthorization() {
            var request = new HttpRequestMessage();

            // Set the header with a strong type.
            string username = "user";
            string password = "password";
            var buffer = Windows.Security.Cryptography.CryptographicBuffer.ConvertStringToBinary(username + ":" + password, Windows.Security.Cryptography.BinaryStringEncoding.Utf16LE);
            string base64token = Windows.Security.Cryptography.CryptographicBuffer.EncodeToBase64String(buffer);
            request.Headers.ProxyAuthorization = new HttpCredentialsHeaderValue("Basic", base64token);


            // Get the strong type out
            System.Diagnostics.Debug.WriteLine("One of the ProxyAuthorixation values: {0}={1}",
                request.Headers.ProxyAuthorization.Scheme,
                request.Headers.ProxyAuthorization.Token);

            // The ToString() is useful for diagnostics, too.
            System.Diagnostics.Debug.WriteLine("The ProxyAuthorization ToString() results: {0}", request.Headers.ProxyAuthorization.ToString());
        }

Comentarios

La clase HttpCredentialsHeaderValue representa el encabezado HTTP Authorization oProxy-Authorization en una solicitud HTTP.

La propiedad Authorization de HttpRequestHeaderCollection devuelve un objeto HttpCredentialsHeaderValue que representa el encabezado HTTP de autorización . La propiedad ProxyAuthorization de HttpRequestHeaderCollection devuelve un objeto HttpCredentialsHeaderValue que representa el encabezado HTTP Proxy-Authorization .

Constructores

HttpCredentialsHeaderValue(String)	Inicializa una nueva instancia de la clase HttpCredentialsHeaderValue con el esquema que se va a usar para la autenticación.
HttpCredentialsHeaderValue(String, String)	Inicializa una nueva instancia de la clase HttpCredentialsHeaderValue con la información de esquema y token de usuario que se va a usar para la autenticación.

Propiedades

Parameters	Obtiene un conjunto de pares nombre-valor incluidos en el encabezado HTTP Authorization o Proxy-Authorization .
Scheme	Obtiene el esquema que se va a usar para la autenticación.
Token	Obtiene la información del token de usuario usada en el encabezado HTTP Authorization o Proxy-Authorization .

Métodos

Parse(String)	Convierte una cadena en una instancia de HttpCredentialsHeaderValue .
ToString()	Devuelve una cadena que representa el objeto HttpCredentialsHeaderValue actual.
TryParse(String, HttpCredentialsHeaderValue)	Determina si una cadena es información válida de HttpCredentialsHeaderValue .

Consulte también

• Authorization
• HttpRequestHeaderCollection
• IStringable
• ProxyAuthorization