NetworkCredential Classe

Definizione

Spazio dei nomi:

System.Net

Assembly:

System.Net.Primitives.dll

Origine:

NetworkCredential.cs

Fornisce le credenziali per gli schemi di autenticazione basata su password, come l'autenticazione di base, digest, NTLM e Kerberos.

public ref class NetworkCredential : System::Net::ICredentials, System::Net::ICredentialsByHost

public class NetworkCredential : System.Net.ICredentials, System.Net.ICredentialsByHost

type NetworkCredential = class
    interface ICredentials
    interface ICredentialsByHost

Public Class NetworkCredential
Implements ICredentials, ICredentialsByHost

Ereditarietà

Object

NetworkCredential

Implementazioni

ICredentials ICredentialsByHost

Esempio

Nell'esempio di codice seguente viene associato un NetworkCredential oggetto a un set di URI (Uniform Resource Identifiers) in un CredentialCacheoggetto . Passa quindi a CredentialCache un oggetto, che lo usa per autenticare le richieste a un HttpClient server Internet.

NetworkCredential^ myCred = gcnew NetworkCredential(
   SecurelyStoredUserName,SecurelyStoredPassword,SecurelyStoredDomain );

CredentialCache^ myCache = gcnew CredentialCache;

myCache->Add( gcnew Uri( "http://www.contoso.com" ), "Basic", myCred );
myCache->Add( gcnew Uri( "http://app.contoso.com" ), "Basic", myCred );

// HttpClient lifecycle management best practices:
// https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
HttpClientHandler^ handler = gcnew HttpClientHandler();
handler->Credentials = myCache;
HttpClient^ client = gcnew HttpClient(handler);

NetworkCredential myCred = new NetworkCredential(
    SecurelyStoredUserName,SecurelyStoredPassword,SecurelyStoredDomain);

CredentialCache myCache = new CredentialCache();

myCache.Add(new Uri("http://www.contoso.com"), "Basic", myCred);
myCache.Add(new Uri("http://app.contoso.com"), "Basic", myCred);

// HttpClient lifecycle management best practices:
// https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
HttpClient client = new HttpClient(new HttpClientHandler
{
    Credentials = myCache
});

Dim myCred As New NetworkCredential(SecurelyStoredUserName, SecurelyStoredPassword, SecurelyStoredDomain)

Dim myCache As New CredentialCache()

myCache.Add(New Uri("http://www.contoso.com"), "Basic", myCred)
myCache.Add(New Uri("http://app.contoso.com"), "Basic", myCred)
       
' HttpClient lifecycle management best practices:
' https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
Dim client As New HttpClient(New HttpClientHandler With
{
    .Credentials = myCache
})

Commenti

La NetworkCredential classe è una classe di base che fornisce le credenziali negli schemi di autenticazione basati su password, ad esempio basic, digest, NTLM e Kerberos. Classi che implementano l'interfaccia, ad esempio la ICredentialsCredentialCache classe, restituiscono NetworkCredential oggetti.

Questa classe non supporta metodi di autenticazione basati su chiavi pubbliche, ad esempio l'autenticazione client Secure Sockets Layer (SSL).

Costruttori

NetworkCredential()	Inizializza una nuova istanza della classe NetworkCredential.
NetworkCredential(String, SecureString)	Inizializza una nuova istanza della classe NetworkCredential con il nome utente e la password specificati.
NetworkCredential(String, SecureString, String)	Inizializza una nuova istanza della classe NetworkCredential con il nome utente, la password e il dominio specificati.
NetworkCredential(String, String)	Inizializza una nuova istanza della classe NetworkCredential con il nome utente e la password specificati.
NetworkCredential(String, String, String)	Inizializza una nuova istanza della classe NetworkCredential con il nome utente, la password e il dominio specificati.

Proprietà

Domain	Recupera o imposta il dominio o il nome del computer che verifica le credenziali.
Password	Recupera o imposta la password per il nome utente associato alle credenziali.
SecurePassword	Ottiene o imposta la password come istanza di SecureString.
UserName	Recupera o imposta il nome utente associato alle credenziali.

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetCredential(String, Int32, String)	Restituisce un'istanza della classe NetworkCredential per l'host, la porta e il tipo di autenticazione specificati.
GetCredential(Uri, String)	Restituisce un'istanza della classe NetworkCredential per l'URI (Uniform Resource Identifier) e il tipo di autenticazione specificati.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)