Partager via


NetworkCredential Classe

Définition

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

S’applique à