HttpCredentialsHeaderValue Classe

Definizione

Spazio dei nomi:

Windows.Web.Http.Headers

Rappresenta il valore dell'intestazione HTTP Authorization o Proxy-Authorization in una richiesta 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

Ereditarietà

Object Platform::Object IInspectable HttpCredentialsHeaderValue

Attributi

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementazioni

IStringable

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

Il codice di esempio seguente illustra un metodo per ottenere e impostare l'intestazione HTTP Authorization su un oggetto HttpRequestMessage usando le proprietà e i metodi nella classe 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());
        }

Il codice di esempio seguente illustra un metodo per ottenere e impostare l'intestazione HTTP Proxy-Authorization su un oggetto HttpRequestMessage usando le proprietà e i metodi nella classe 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());
        }

Commenti

La classe HttpCredentialsHeaderValue rappresenta l'intestazione HTTP Authorization o Proxy-Authorization in una richiesta HTTP.

La proprietà Authorization in HttpRequestHeaderCollection restituisce un oggetto HttpCredentialsHeaderValue che rappresenta l'intestazione HTTP authorization . La proprietà ProxyAuthorization in HttpRequestHeaderCollection restituisce un oggetto HttpCredentialsHeaderValue che rappresenta l'intestazione HTTP Proxy-Authorization .

Costruttori

HttpCredentialsHeaderValue(String)	Inizializza una nuova istanza della classe HttpCredentialsHeaderValue con lo schema da usare per l'autenticazione.
HttpCredentialsHeaderValue(String, String)	Inizializza una nuova istanza della classe HttpCredentialsHeaderValue con lo schema e le informazioni sul token utente da usare per l'autenticazione.

Proprietà

Parameters	Ottiene un set di coppie nome/valore incluse nell'intestazione HTTP Authorization o Proxy-Authorization .
Scheme	Ottiene lo schema da utilizzare per l'autenticazione.
Token	Ottiene le informazioni sul token utente utilizzate nell'intestazione HTTP Authorization o Proxy-Authorization .

Metodi

Parse(String)	Converte una stringa in un'istanza httpCredentialsHeaderValue .
ToString()	Restituisce una stringa che rappresenta l'oggetto HttpCredentialsHeaderValue corrente.
TryParse(String, HttpCredentialsHeaderValue)	Determina se una stringa è un valore HttpCredentialsHeaderValue valido.

Vedi anche

• Authorization
• HttpRequestHeaderCollection
• IStringable
• ProxyAuthorization