HttpCredentialsHeaderValue Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.Web.Http.Headers

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Rappresenta il valore dell'intestazione HTTP Authorization o Proxy-Authorization in una richiesta HTTP.

public ref class HttpCredentialsHeaderValue sealed : IStringable

/// [Windows.Foundation.Metadata.Activatable(Windows.Web.Http.Headers.IHttpCredentialsHeaderValueFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class HttpCredentialsHeaderValue final : 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.Activatable(typeof(Windows.Web.Http.Headers.IHttpCredentialsHeaderValueFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class HttpCredentialsHeaderValue : 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.

Si applica a

Condividi tramite