NetworkCredential Classe

Définition

Espace de noms:

System.Net

Assembly:

System.Net.Primitives.dll

Source:

NetworkCredential.cs

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 class NetworkCredential : System.Net.ICredentials, System.Net.ICredentialsByHost

type NetworkCredential = class
    interface ICredentials
    interface ICredentialsByHost

Public Class NetworkCredential
Implements ICredentials, ICredentialsByHost

Héritage

Object

NetworkCredential

Implémente

ICredentials ICredentialsByHost

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://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
})

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)