NetworkCredential Classe
Definizione
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.
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) |