CredentialCache.Add Méthode

Définition

Espace de noms:

System.Net

Assembly:

System.Net.Primitives.dll

Ajoute une instance de NetworkCredential au cache des informations d’identification.

Surcharges

Add(Uri, String, NetworkCredential)	Ajoute au cache d’informations d’identification une instance de NetworkCredential à utiliser avec des protocoles autres que SMTP, et l’associe à un préfixe URI (Uniform Resource Identifier) ainsi qu’à un protocole d’authentification.
Add(String, Int32, String, NetworkCredential)	Ajoute au cache d’informations d’identification une instance de NetworkCredential à utiliser avec SMTP et l’associe à un ordinateur hôte, à un port et à un protocole d’authentification. Les informations d’identification ajoutées avec cette méthode peuvent uniquement être utilisées avec SMTP. Cette méthode ne fonctionne pas pour les requêtes HTTP ou FTP.

Add(Uri, String, NetworkCredential)

Source:

CredentialCache.cs

Ajoute au cache d’informations d’identification une instance de NetworkCredential à utiliser avec des protocoles autres que SMTP, et l’associe à un préfixe URI (Uniform Resource Identifier) ainsi qu’à un protocole d’authentification.

public:
 void Add(Uri ^ uriPrefix, System::String ^ authType, System::Net::NetworkCredential ^ cred);

public void Add (Uri uriPrefix, string authType, System.Net.NetworkCredential cred);

member this.Add : Uri * string * System.Net.NetworkCredential -> unit

Public Sub Add (uriPrefix As Uri, authType As String, cred As NetworkCredential)

Paramètres

uriPrefix

Uri

Uri qui spécifie le préfixe URI des ressources auxquelles les informations d’identification autorisent l’accès.

authType

String

Schéma d'authentification utilisé par la ressource nommée dans uriPrefix.

cred

NetworkCredential

NetworkCredential à ajouter au cache des informations d’identification.

Exceptions

ArgumentNullException

uriPrefix a la valeur null.

-ou-

authType a la valeur null.

ArgumentException

Les mêmes informations d’identification sont ajoutées à plusieurs reprises.

Exemples

L’exemple de code suivant initialise un CredentialCache avec plusieurs informations d’identification de sécurité et utilise ces informations d’identification avec un WebRequest.

CredentialCache^ myCache = gcnew CredentialCache;

myCache->Add( gcnew Uri( "http://www.contoso.com/" ), "Basic", gcnew NetworkCredential( UserName,SecurelyStoredPassword ) );
myCache->Add( gcnew Uri( "http://www.contoso.com/" ), "Digest", gcnew NetworkCredential( UserName,SecurelyStoredPassword,Domain ) );

wReq->Credentials = myCache;

CredentialCache myCache = new CredentialCache();

myCache.Add(new Uri("http://www.contoso.com/"),"Basic",new NetworkCredential(UserName,SecurelyStoredPassword));
myCache.Add(new Uri("http://www.contoso.com/"),"Digest", new NetworkCredential(UserName,SecurelyStoredPassword,Domain));

wReq.Credentials = myCache;

Dim myCache As New CredentialCache()

myCache.Add(New Uri("http://www.contoso.com/"), "Basic", New NetworkCredential(UserName, SecurelyStoredPassword))
myCache.Add(New Uri("http://www.contoso.com/"), "Digest", New NetworkCredential(UserName, SecurelyStoredPassword, Domain))

wReq.Credentials = myCache

Remarques

La Add méthode place une NetworkCredential instance à utiliser avec des protocoles autres que SMTP dans le CredentialCache. Le cache stocke les informations d’identification dans l’ordre dans lequel elles y sont ajoutées. Lorsque la GetCredential(Uri, String) méthode est appelée, elle retourne l’instance correspondante NetworkCredential appropriée.

Add(String, Int32, String, NetworkCredential)

Source:

CredentialCache.cs

Ajoute au cache d’informations d’identification une instance de NetworkCredential à utiliser avec SMTP et l’associe à un ordinateur hôte, à un port et à un protocole d’authentification. Les informations d’identification ajoutées avec cette méthode peuvent uniquement être utilisées avec SMTP. Cette méthode ne fonctionne pas pour les requêtes HTTP ou FTP.

public:
 void Add(System::String ^ host, int port, System::String ^ authenticationType, System::Net::NetworkCredential ^ credential);

public void Add (string host, int port, string authenticationType, System.Net.NetworkCredential credential);

member this.Add : string * int * string * System.Net.NetworkCredential -> unit

Public Sub Add (host As String, port As Integer, authenticationType As String, credential As NetworkCredential)

Paramètres

host

String

String qui identifie l’ordinateur hôte.

port

Int32

Int32 qui spécifie le port auquel se connecter sur host

authenticationType

String

String qui identifie le schéma d'authentification utilisé lors de la connexion à host à l'aide de cred.

credential

NetworkCredential

NetworkCredential à ajouter au cache des informations d’identification.

Exceptions

ArgumentNullException

host a la valeur null.

-ou-

authType a la valeur null.

ArgumentException

authType n’est pas une valeur admise.

ArgumentOutOfRangeException

port est inférieur à zéro.

Exemples

L’exemple de code suivant initialise un CredentialCache avec plusieurs informations d’identification de sécurité à utiliser avec SMTP et utilise l’une de ces informations d’identification avec un SmtpClient.

SmtpClient^ client = gcnew SmtpClient("ContosoMail", 45);
MailAddress^ from = gcnew MailAddress("sender@SenderMailServerName.com", "Sender Name");
MailAddress^ to = gcnew MailAddress("recepient@RecepientMailServerName.com", "Recepient Name");
MailMessage^ message = gcnew MailMessage(from, to);

message->Body = "This is a test email message sent by an application. ";
message->Subject = "Test Email using Credentials";

NetworkCredential^ myCreds = gcnew NetworkCredential("username", "password", "domain");
CredentialCache^ myCredentialCache = gcnew CredentialCache();        
try 
{
    myCredentialCache->Add("ContoscoMail", 35, "Basic", myCreds);
    myCredentialCache->Add("ContoscoMail", 45, "NTLM", myCreds);
            
    client->Credentials = myCredentialCache->GetCredential("ContosoMail", 45, "NTLM");
    client->Send(message);
    Console::WriteLine("Goodbye.");
}
    catch(Exception^ e)
    {
          Console::WriteLine("Exception is raised. ");
          Console::WriteLine("Message: {0} ",e->Message);
    }

SmtpClient client = new SmtpClient("ContosoMail", 45);
MailAddress from = new MailAddress("sender@SenderMailServerName.com", "Sender Name");
MailAddress to = new MailAddress("recepient@RecepientMailServerName.com", "Recepient Name");
MailMessage message = new MailMessage(from, to);

message.Body = "This is a test email message sent by an application. ";
message.Subject = "Test Email using Credentials";

NetworkCredential myCreds = new NetworkCredential("username", "password", "domain");
CredentialCache myCredentialCache = new CredentialCache();
try
{
    myCredentialCache.Add("ContoscoMail", 35, "Basic", myCreds);
    myCredentialCache.Add("ContoscoMail", 45, "NTLM", myCreds);

    client.Credentials = myCredentialCache.GetCredential("ContosoMail", 45, "NTLM");
    client.Send(message);
    Console.WriteLine("Goodbye.");
}
    catch(Exception e)
    {
          Console.WriteLine("Exception is raised. ");
          Console.WriteLine("Message: {0} ",e.Message);
    }

Dim client As New SmtpClient("ContosoMail", 45)
Dim from As New MailAddress("sender@SenderMailServerName.com", "Sender Name")
Dim sendTo As New MailAddress("recepient@RecepientMailServerName.com", "Recepient Name")
Dim message As New MailMessage(from, sendTo)

message.Body = "This is a test email message sent by an application. "
message.Subject = "Test Email using Credentials"

Dim myCreds As New NetworkCredential("username", "password", "domain")
DIm myCredentialCache As New CredentialCache()

Try 
    myCredentialCache.Add("ContoscoMail", 35, "Basic", myCreds)
    myCredentialCache.Add("ContoscoMail", 45, "NTLM", myCreds)

    client.Credentials = myCredentialCache.GetCredential("ContosoMail", 45, "NTLM")
    client.Send(message)
    Console.WriteLine("Goodbye.")
Catch e As Exception
    Console.WriteLine("Exception is raised. ")
    Console.WriteLine($"Message: {e.Message} ")
End Try

Remarques

Cette méthode place une NetworkCredential instance à utiliser avec SMTP dans le CredentialCache. Le cache stocke les informations d’identification dans l’ordre dans lequel elles y sont ajoutées. Lorsque la GetCredential(String, Int32, String) méthode est appelée, elle retourne une NetworkCredential instance qui est sélectionnée en correspondant à host, portet authType. La comparaison ne respecte pas la casse.

Les valeurs prises en charge pour authType sont « NTLM », « Digest », « Kerberos » et « Negotiate ».

Les informations d’identification ajoutées avec cette méthode sont uniquement valides pour une utilisation avec SMTP. Cette méthode ne fonctionne pas pour les protocoles HTTP ou FTP.