Partager via


CredentialCache.Add Méthode

Définition

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
Source:
CredentialCache.cs
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

uriPrefix a la valeur null.

-ou-

authType a la valeur null.

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.

S’applique à

Add(String, Int32, String, NetworkCredential)

Source:
CredentialCache.cs
Source:
CredentialCache.cs
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

host a la valeur null.

-ou-

authType a la valeur null.

authType n’est pas une valeur admise.

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.

S’applique à