SmtpClient.Credentials 屬性

定義

命名空間:

System.Net.Mail

組件:

System.Net.Mail.dll

來源:

SmtpClient.cs

取得或設定用來驗證寄件者的認證。

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

屬性值

ICredentialsByHost

ICredentialsByHost，表示用於驗證的認證，如果未指定認證則為 null。

例外狀況

InvalidOperationException

正在傳送電子郵件時，無法變更這個屬性的值。

範例

下列程式代碼範例示範如何設定用來傳送電子郵件的認證。

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);
}

備註

某些 SMTP 伺服器要求客戶端必須先經過驗證，伺服器才會代表其傳送電子郵件。 若要使用預設網路認證，您可以將 設定 UseDefaultCredentials 為 true ，而不是設定此屬性。 UseDefaultCredentials如果 屬性設定false,為 ，則在連接到伺服器時，屬性中Credentials設定的值將會用於認證。 UseDefaultCredentials如果屬性設定false為 ，且Credentials屬性尚未設定，則會以匿名方式將郵件傳送至伺服器。

您也可以使用應用程式和電腦組態檔來指定認證資訊。 如需詳細資訊，請參閱 <mailSettings> 元素 (網路設定) 。 如果使用 屬性指定 Credentials 資訊，這項資訊會覆寫組態檔設定。

警告

如果您提供認證進行基本驗證，則會以純文字形式將它們傳送給伺服器。 這可能會顯示安全性問題，因為您的認證可以看見，然後供其他人使用。