CredentialCache.Add Yöntem

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Net.Primitives.dll

Kimlik bilgisi önbelleğine bir NetworkCredential örnek ekler.

Aşırı Yüklemeler

Name	Description
Add(Uri, String, NetworkCredential)	SMTP dışındaki protokollerle kullanılmak üzere kimlik bilgisi önbelleğine bir NetworkCredential örnek ekler ve bunu tekdüzen Kaynak Tanımlayıcısı (URI) ön eki ve kimlik doğrulama protokolüyle ilişkilendirir.
Add(String, Int32, String, NetworkCredential)	Kimlik bilgisi önbelleğine SMTP ile kullanmak üzere bir NetworkCredential örnek ekler ve bunu bir konak bilgisayar, bağlantı noktası ve kimlik doğrulama protokolüyle ilişkilendirir. Bu yöntem kullanılarak eklenen kimlik bilgileri yalnızca SMTP için geçerlidir. Bu yöntem HTTP veya FTP istekleri için çalışmaz.

Add(Uri, String, NetworkCredential)

Kaynak:

CredentialCache.cs

SMTP dışındaki protokollerle kullanılmak üzere kimlik bilgisi önbelleğine bir NetworkCredential örnek ekler ve bunu tekdüzen Kaynak Tanımlayıcısı (URI) ön eki ve kimlik doğrulama protokolüyle ilişkilendirir.

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)

Parametreler

uriPrefix

Uri

Uri Kimlik bilgilerinin erişim izni veren kaynakların URI ön ekini belirten bir.

authType

String

adlı kaynak uriPrefixtarafından kullanılan kimlik doğrulama düzeni.

cred

NetworkCredential

NetworkCredential kimlik bilgisi önbelleğine eklenecek.

Özel durumlar

ArgumentNullException

uriPrefix, null'e eşittir.

-veya-

authType, null'e eşittir.

ArgumentException

Aynı kimlik bilgileri birden çok kez eklenir.

Örnekler

Aşağıdaki kod örneği, birden çok güvenlik kimlik bilgileriyle bir CredentialCache başlatır ve bu kimlik bilgilerini ile WebRequestkullanır.

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

Açıklamalar

yöntemi içine Add SMTP NetworkCredentialdışındaki protokollerle kullanılacak bir CredentialCache örnek yerleştirir. Önbellek, kimlik bilgilerini bu kimlik bilgilerine eklendikleri sırayla depolar. GetCredential(Uri, String) yöntemi çağrıldığında uygun eşleşen NetworkCredential örneği döndürür.

Add(String, Int32, String, NetworkCredential)

Kaynak:

CredentialCache.cs

Kimlik bilgisi önbelleğine SMTP ile kullanmak üzere bir NetworkCredential örnek ekler ve bunu bir konak bilgisayar, bağlantı noktası ve kimlik doğrulama protokolüyle ilişkilendirir. Bu yöntem kullanılarak eklenen kimlik bilgileri yalnızca SMTP için geçerlidir. Bu yöntem HTTP veya FTP istekleri için çalışmaz.

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)

Parametreler

host

String

String Ana bilgisayarı tanımlayan bir.

port

Int32

Int32 üzerinde hostbağlanacak bağlantı noktasını belirten bir.

authenticationType

String

String kullanarak hostöğesine bağlanırken credential kullanılan kimlik doğrulama düzenini tanımlayan bir.

credential

NetworkCredential

NetworkCredential kimlik bilgisi önbelleğine eklenecek.

Özel durumlar

ArgumentNullException

host, null'e eşittir.

-veya-

authenticationType, null'e eşittir.

ArgumentException

authenticationType kabul edilen bir değer değildir.

ArgumentOutOfRangeException

port, sıfırdan küçüktür.

Örnekler

Aşağıdaki kod örneği, SMTP ile kullanmak üzere birden çok güvenlik kimlik bilgileriyle bir CredentialCache başlatır ve bu kimlik bilgilerinden birini ile SmtpClientkullanır.

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

Açıklamalar

Bu yöntem, SMTP ile kullanılacak bir NetworkCredential örneği içine CredentialCacheyerleştirir. Önbellek, kimlik bilgilerini bu kimlik bilgilerine eklendikleri sırayla depolar. GetCredential(String, Int32, String) yöntemi çağrıldığında, , NetworkCredentialve hostile eşleştirilerek portseçilen bir authenticationType örneği döndürür. Karşılaştırma büyük/küçük harfe duyarsız olarak yapılır.

için authenticationType desteklenen değerler "NTLM", "Digest", "Kerberos" ve "Negotiate" değerleridir.

Bu yöntemle eklenen kimlik bilgileri yalnızca SMTP ile kullanım için geçerlidir. Bu yöntem HTTP veya FTP protokolleri için çalışmaz.