SmtpClient.Credentials Özellik

Tanım

Ad Alanı:

System.Net.Mail

Bütünleştirilmiş Kod:

System.Net.Mail.dll

Kaynak:

SmtpClient.cs

Gönderenin kimliğini doğrulamak için kullanılan kimlik bilgilerini alır veya ayarlar.

public:
 property System::Net::ICredentialsByHost ^ Credentials { System::Net::ICredentialsByHost ^ get(); void set(System::Net::ICredentialsByHost ^ value); };

public System.Net.ICredentialsByHost? Credentials { get; set; }

member this.Credentials : System.Net.ICredentialsByHost with get, set

Public Property Credentials As ICredentialsByHost

Özellik Değeri

ICredentialsByHost

ICredentialsByHost Kimlik doğrulaması için kullanılacak kimlik bilgilerini temsil eden veya null kimlik bilgisi belirtilmediyse.

Özel durumlar

InvalidOperationException

E-posta gönderilirken bu özelliğin değerini değiştiremezsiniz.

Örnekler

Aşağıdaki kod örneğinde, e-posta göndermek için kullanılan kimlik bilgilerinin ayarlanması gösterilmektedir.

static void CreateTestMessage1( String^ server, int port )
{
   String^ to = L"jane@contoso.com";
   String^ from = L"ben@contoso.com";
   String^ subject = L"Using the new SMTP client.";
   String^ body = L"Using this new feature, you can send an email message from an application very easily.";
   MailMessage^ message = gcnew MailMessage( from,to,subject,body );
   SmtpClient^ client = gcnew SmtpClient( server,port );
   
   // Credentials are necessary if the server requires the client 
   // to authenticate before it will send email on the client's behalf.
   client->Credentials = CredentialCache::DefaultNetworkCredentials;
   client->Send( message );
   client->~SmtpClient();
}

public static void CreateTestMessage1(string server, int port)
{
    string to = "jane@contoso.com";
    string from = "ben@contoso.com";
    string subject = "Using the new SMTP client.";
    string body = @"Using this new feature, you can send an email message from an application very easily.";
    MailMessage message = new MailMessage(from, to, subject, body);
    SmtpClient client = new SmtpClient(server, port);
    // Credentials are necessary if the server requires the client
    // to authenticate before it will send email on the client's behalf.
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    client.Send(message);
}

Açıklamalar

Bazı SMTP sunucuları, sunucunun adına e-posta göndermeden önce istemcinin kimliğinin doğrulanması gerekir. Varsayılan ağ kimlik bilgilerinizi kullanmak için, bu özelliği ayarlamak UseDefaultCredentials yerine olarak true ayarlayabilirsiniz. UseDefaultCredentials özelliği olarak ayarlanırsa, sunucuya false, bağlanırken kimlik bilgileri için özelliğinde Credentials ayarlanan değer kullanılır. UseDefaultCredentials Özellik olarak ayarlandıysa false ve Credentials özellik ayarlanmamışsa, sunucuya anonim olarak posta gönderilir.

Kimlik bilgileri, uygulama ve makine yapılandırma dosyaları kullanılarak da belirtilebilir. Daha fazla bilgi için bkz <. mailSettings> Öğesi (Ağ Ayarları). özelliği kullanılarak Credentials bilgi belirtilirse, bu bilgiler yapılandırma dosyası ayarlarını geçersiz kılar.

Dikkat

Temel kimlik doğrulaması için kimlik bilgilerini sağlarsanız, bunlar sunucuya düz metin olarak gönderilir. Kimlik bilgileriniz başkaları tarafından görülebildiği ve kullanabildiği için bu bir güvenlik sorununa neden olabilir.