SmtpClient.Credentials 属性

定义

命名空间:

System.Net.Mail

程序集:

System.Net.Mail.dll

Source:

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 服务器要求先对客户端进行身份验证，然后服务器才会代表客户端发送电子邮件。 若要使用默认网络凭据，可以将 设置为 UseDefaultCredentialstrue ，而不是设置此属性。 如果 属性 UseDefaultCredentials 设置为 false, ，则在连接到服务器时， Credentials 属性中设置的值将用于凭据。 如果 属性 UseDefaultCredentials 设置为 false ，但尚未设置 该 Credentials 属性，则邮件以匿名方式发送到服务器。

还可以使用应用程序和计算机配置文件指定凭据信息。 有关详细信息，请参阅 <mailSettings> 元素 (网络设置) 。 如果使用 属性指定 Credentials 信息，则此信息将覆盖配置文件设置。

注意

如果提供了用于基本身份验证的凭据，这些凭据将以明文形式发送到服务器。 这可能导致安全问题，因为可以看到你的凭据，然后被其他人使用。