NetworkCredential Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit des informations d’identification pour les schémas d’authentification basée sur le mot de passe tels que l’authentification de base, Digest, NTLM et 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
- Héritage
-
NetworkCredential
- Implémente
Exemples
L’exemple de code suivant associe un NetworkCredential objet à un ensemble d’URI (Uniform Resource Identifiers) dans un CredentialCache. Il passe ensuite le CredentialCache à un HttpClient objet, qui l’utilise pour authentifier les demandes adressées à un serveur 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://zcusa.951200.xyz/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://zcusa.951200.xyz/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://zcusa.951200.xyz/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
Dim client As New HttpClient(New HttpClientHandler With
{
.Credentials = myCache
})
Remarques
La NetworkCredential classe est une classe de base qui fournit des informations d’identification dans des schémas d’authentification basés sur un mot de passe tels que basic, digest, NTLM et Kerberos. Les classes qui implémentent l’interface ICredentials , comme la CredentialCache classe, retournent NetworkCredential des objets.
Cette classe ne prend pas en charge les méthodes d’authentification basées sur une clé publique telles que l’authentification du client SSL (Secure Sockets Layer).
Constructeurs
NetworkCredential() |
Initialise une nouvelle instance de la classe NetworkCredential. |
NetworkCredential(String, SecureString) |
Initialise une nouvelle instance de la classe NetworkCredential avec le nom d'utilisateur et le mot de passe spécifiés. |
NetworkCredential(String, SecureString, String) |
Initialise une nouvelle instance de la classe NetworkCredential avec le nom d'utilisateur, le mot de passe et le domaine spécifiés. |
NetworkCredential(String, String) |
Initialise une nouvelle instance de la classe NetworkCredential avec le nom d'utilisateur et le mot de passe spécifiés. |
NetworkCredential(String, String, String) |
Initialise une nouvelle instance de la classe NetworkCredential avec le nom d'utilisateur, le mot de passe et le domaine spécifiés. |
Propriétés
Domain |
Obtient ou définit le nom de domaine ou d'ordinateur qui vérifie les informations d'identification. |
Password |
Obtient ou définit le mot de passe correspondant au nom d'utilisateur associé aux informations d'identification. |
SecurePassword |
Obtient ou définit le mot de passe en tant qu'instance de SecureString. |
UserName |
Obtient ou définit le nom d'utilisateur associé aux informations d'identification. |
Méthodes
Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
GetCredential(String, Int32, String) |
Retourne une instance de la classe NetworkCredential pour l'hôte, le port et le type d'authentification spécifiés. |
GetCredential(Uri, String) |
Retourne une instance de la classe NetworkCredential pour l'URI (Uniform Resource Identifier) et le type d'authentification spécifiés. |
GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |