NetworkCredential Classe

Definizione

Fornisce le credenziali per gli schemi di autenticazione basati su password, ad esempio l'autenticazione di base, digest, NTLM e Kerberos.

public ref class NetworkCredential : System::Net::ICredentials, System::Net::ICredentialsByHost
public ref class NetworkCredential : System::Net::ICredentials
public class NetworkCredential : System.Net.ICredentials, System.Net.ICredentialsByHost
public class NetworkCredential : System.Net.ICredentials
type NetworkCredential = class
    interface ICredentials
    interface ICredentialsByHost
type NetworkCredential = class
    interface ICredentials
Public Class NetworkCredential
Implements ICredentials, ICredentialsByHost
Public Class NetworkCredential
Implements ICredentials
Ereditarietà
NetworkCredential
Implementazioni

Esempio

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

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 base che fornisce le credenziali negli schemi di autenticazione basati su password, ad esempio basic, digest, NTLM e Kerberos. Classi che implementano l'interfaccia ICredentials , ad esempio la CredentialCache classe , restituiscono NetworkCredential oggetti .

Note

Nelle piattaforme Unix, l'uso dell'autenticazione NTLM può richiedere l'installazione del plug-in NTLM per il livello GSSAPI usato dall'implementazione. Nelle distribuzioni Ubuntu il pacchetto viene chiamato gss-ntlmssp. In alternativa, le applicazioni possono acconsentire esplicitamente a un'implementazione gestita di NTLM impostando la proprietà _UseManagedNtlm .csproj (solo .NET 9+) o impostando l'opzione System.Net.Security.UseManagedNtlm AppContext.

In Windows, l'autenticazione NTLM e Negotiate (Kerberos) dipende sempre da GSSAPI del sistema operativo.

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

Costruttori

Nome Descrizione
NetworkCredential()

Inizializza una nuova istanza della classe NetworkCredential.

NetworkCredential(String, SecureString, String)

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

NetworkCredential(String, SecureString)

Inizializza una nuova istanza della classe con il nome utente e la NetworkCredential password specificati.

NetworkCredential(String, String, String)

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

NetworkCredential(String, String)

Inizializza una nuova istanza della classe con il nome utente e la NetworkCredential password specificati.

Proprietà

Nome Descrizione
Domain

Ottiene o imposta il nome di dominio o computer che verifica le credenziali.

Password

Ottiene o imposta la password per il nome utente associato alle credenziali.

SecurePassword

Ottiene o imposta la password come SecureString istanza di .

UserName

Ottiene o imposta il nome utente associato alle credenziali.

Metodi

Nome Descrizione
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetCredential(String, Int32, String)

Restituisce un'istanza della NetworkCredential classe per l'host, la porta e il tipo di autenticazione specificati.

GetCredential(Uri, String)

Restituisce un'istanza della NetworkCredential classe per il tipo di autenticazione e l'URI (Uniform Resource Identifier) specificati.

GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Si applica a