CredentialCache.Add Metoda

Definicja

Przestrzeń nazw:

System.Net

Zestawy:

netstandard.dll, System.Net.Primitives.dll

NetworkCredential Dodaje wystąpienie do pamięci podręcznej poświadczeń.

Przeciążenia

Nazwa	Opis
Add(Uri, String, NetworkCredential)	NetworkCredential Dodaje wystąpienie do pamięci podręcznej poświadczeń do użycia z protokołami innymi niż SMTP i kojarzy je z prefiksem Uniform Resource Identifier (URI) i protokołem uwierzytelniania.
Add(String, Int32, String, NetworkCredential)	NetworkCredential Dodaje wystąpienie do użycia z protokołem SMTP do pamięci podręcznej poświadczeń i kojarzy je z komputerem hosta, portem i protokołem uwierzytelniania. Poświadczenia dodane przy użyciu tej metody są prawidłowe tylko dla protokołu SMTP. Ta metoda nie działa w przypadku żądań HTTP ani FTP.

Add(Uri, String, NetworkCredential)

Źródło:

CredentialCache.cs

NetworkCredential Dodaje wystąpienie do pamięci podręcznej poświadczeń do użycia z protokołami innymi niż SMTP i kojarzy je z prefiksem Uniform Resource Identifier (URI) i protokołem uwierzytelniania.

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)

Parametry

uriPrefix

Uri

Element Uri określający prefiks identyfikatora URI zasobów, do których poświadczenie udziela dostępu.

authType

String

Schemat uwierzytelniania używany przez zasób o nazwie w uriPrefix.

cred

NetworkCredential

Element NetworkCredential do dodania do pamięci podręcznej poświadczeń.

Wyjątki

ArgumentNullException

Parametr uriPrefix ma wartość null.

— lub —

Parametr authType ma wartość null.

ArgumentException

Te same poświadczenia są dodawane więcej niż raz.

Przykłady

Poniższy przykład kodu inicjuje CredentialCache element z wieloma poświadczeniami zabezpieczeń i używa tych poświadczeń z elementem WebRequest.

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

Uwagi

Metoda Add umieszcza NetworkCredential wystąpienie do użycia z protokołami innymi niż SMTP w obiekcie CredentialCache. Pamięć podręczna przechowuje poświadczenia w kolejności, w której są do niej dodawane. Gdy metoda jest wywoływana GetCredential(Uri, String) , zwraca odpowiednie zgodne NetworkCredential wystąpienie.

Add(String, Int32, String, NetworkCredential)

Źródło:

CredentialCache.cs

NetworkCredential Dodaje wystąpienie do użycia z protokołem SMTP do pamięci podręcznej poświadczeń i kojarzy je z komputerem hosta, portem i protokołem uwierzytelniania. Poświadczenia dodane przy użyciu tej metody są prawidłowe tylko dla protokołu SMTP. Ta metoda nie działa w przypadku żądań HTTP ani 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)

Parametry

host

String

Element String identyfikujący komputer hosta.

port

Int32

Element Int32 określający port, z który ma nawiązać połączenie w systemie host.

authenticationType

String

Element String identyfikujący schemat uwierzytelniania używany podczas nawiązywania połączenia z usługą host .credential

credential

NetworkCredential

Element NetworkCredential do dodania do pamięci podręcznej poświadczeń.

Wyjątki

ArgumentNullException

Parametr host ma wartość null.

— lub —

Parametr authenticationType ma wartość null.

ArgumentException

authenticationType nie jest akceptowaną wartością.

ArgumentOutOfRangeException

Parametr port ma wartość niższą niż zero.

Przykłady

Poniższy przykład kodu inicjuje CredentialCache element z wieloma poświadczeniami zabezpieczeń do użycia z serwerem SMTP i używa jednego z tych poświadczeń z elementem SmtpClient.

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

Uwagi

Ta metoda umieszcza NetworkCredential wystąpienie do użycia z serwerem SMTP w obiekcie CredentialCache. Pamięć podręczna przechowuje poświadczenia w kolejności, w której są do niej dodawane. Po wywołaniu GetCredential(String, Int32, String) metody zwraca NetworkCredential ono wystąpienie wybrane przez dopasowanie wartości host, porti authenticationType. Porównanie jest wykonywane bez uwzględniania wielkości liter.

Obsługiwane wartości authenticationType to "NTLM", "Digest", "Kerberos" i "Negotiate".

Poświadczenia dodane za pomocą tej metody są prawidłowe tylko do użycia z serwerem SMTP. Ta metoda nie działa w przypadku protokołów HTTP ani FTP.