CredentialCache.Add Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Net

Zestaw:: System.Net.Primitives.dll

Zestaw:: System.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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

Przeciążenia

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

Źródło:: CredentialCache.cs

Ź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świadczenia 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

uriPrefix to null.

-lub-

authType to 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 = 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

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. Po wywołaniu GetCredential(Uri, String) metody zwraca odpowiednie zgodne NetworkCredential wystąpienie.

Dotyczy

Add(String, Int32, String, NetworkCredential)

Źródło:: CredentialCache.cs

Źródło:: CredentialCache.cs

Ź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 do nawiązania połączenia z usługą w systemie host.

authenticationType: String

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

credential: NetworkCredential

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

Wyjątki

ArgumentNullException

host to null.

-lub-

authType to null.

ArgumentException

authType 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 = 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

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 hostwartości , porti authType. Porównanie jest wykonywane bez uwzględniania wielkości liter.

Obsługiwane wartości authType 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.

Dotyczy

Udostępnij za pośrednictwem

CredentialCache.Add Metoda

Definicja

Przeciążenia

Add(Uri, String, NetworkCredential)

Parametry

Wyjątki

Przykłady

Uwagi

Dotyczy

Add(String, Int32, String, NetworkCredential)

Parametry

Wyjątki

Przykłady

Uwagi

Dotyczy

Dodatkowe zasoby