CredentialCache.Add Méthode

Référence

Définition

Espace de noms:: System.Net

Assembly:: System.Net.Primitives.dll

Assembly:: System.dll

Assembly:: netstandard.dll

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.

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

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.

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

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.

S’applique à

Partager via

CredentialCache.Add Méthode

Définition

Surcharges

Add(Uri, String, NetworkCredential)

Paramètres

Exceptions

Exemples

Remarques

S’applique à

Add(String, Int32, String, NetworkCredential)

Paramètres

Exceptions

Exemples

Remarques

S’applique à

Ressources supplémentaires