SmtpClient.Send 方法

定義

命名空間:

System.Net.Mail

組件:

System.Net.Mail.dll

傳送電子郵件訊息給 SMTP 伺服器進行傳遞。 在傳送訊息時，會封鎖這些方法。

多載

Send(MailMessage)	傳送指定的訊息給 SMTP 伺服器進行傳遞。
Send(String, String, String, String)	傳送指定的電子郵件訊息給 SMTP 伺服器進行傳遞。 訊息寄件者、收件者、主旨和訊息主體是使用 String 物件來指定。

Send(MailMessage)

來源:

SmtpClient.cs

傳送指定的訊息給 SMTP 伺服器進行傳遞。

C#

public void Send (System.Net.Mail.MailMessage message);

參數

message

MailMessage

MailMessage，包含要傳送的訊息。

例外狀況

ArgumentNullException

message 為 null。

InvalidOperationException

這 SmtpClient 有另一個已在進行中的傳送作業。

-或-

From 為 null。

-或-

To、CC 和Bcc 屬性中沒有指定任何收件者。

-或-

DeliveryMethod 屬性設定為 Network，且 Host 為 null。

-或-

DeliveryMethod 屬性設為 Network，且 Host 等於空字串 ("")。

-或-

DeliveryMethod 屬性設定為 Network ，而且 Port 為零、負數或大於 65,535。

ObjectDisposedException

這個物件已經過處置。

SmtpException

與 SMTP 伺服器的連接失敗。

-或-

驗證失敗。

-或-

作業逾時。

-或-

EnableSsl 設定為 true，但 DeliveryMethod 屬性設定為 SpecifiedPickupDirectory 或 PickupDirectoryFromIis。

-或-

EnableSsl 設為 true, 不過 SMTP 郵件伺服器並未在對 EHLO 命令的回應中通告 STARTTLS。

SmtpFailedRecipientException

無法將 message 傳遞給 To、CC 或 Bcc 中的一個收件者。

SmtpFailedRecipientsException

無法將 message 傳遞給 To、CC 或 Bcc 中的兩個或多個收件者。

範例

下列程式代碼範例示範如何使用這個方法。

C#

public static void CreateTestMessage2(string server)
{
    string to = "jane@contoso.com";
    string from = "ben@contoso.com";
    MailMessage message = new MailMessage(from, to);
    message.Subject = "Using the new SMTP client.";
    message.Body = @"Using this new feature, you can send an email message from an application very easily.";
    SmtpClient client = new SmtpClient(server);
    // Credentials are necessary if the server requires the client
    // to authenticate before it will send email on the client's behalf.
    client.UseDefaultCredentials = true;

    try
    {
        client.Send(message);
    }
    catch (Exception ex)
    {
        Console.WriteLine("Exception caught in CreateTestMessage2(): {0}",
            ex.ToString());
    }
}

備註

此方法會在傳送電子郵件時封鎖。 您可以使用 屬性指定逾時值 Timeout ，以確保方法會在經過指定的時間量之後傳回。

在呼叫此方法之前， Host 必須先透過組態檔來設定 和 Port 屬性，方法是設定相關屬性，或將此資訊傳遞至 SmtpClient(String, Int32) 建構函式。

如果訊息是以異步方式傳送，您就無法呼叫這個方法。

如果 SMTP 主機需要認證，您必須先設定認證，才能呼叫此方法。 若要指定認證，請使用 UseDefaultCredentials 或 Credentials 屬性。

如果您收到 SmtpException 例外狀況，請檢查 StatusCode 屬性以找出作業失敗的原因。 SmtpException也可以包含內部例外狀況，指出作業失敗的原因。

當使用 Send 傳送電子郵件給多個收件者，SMTP 伺服器接受某些收件者為有效，並拒絕其他收件者時， Send 會將電子郵件傳送給已接受的收件者，然後 SmtpFailedRecipientsException 擲回 (，如果 SmtpFailedRecipientException 只有一位收件者遭到拒絕，則會) 。 SmtpFailedRecipientsException包含拒絕的收件者清單。

注意

EnableSsl如果 屬性設定為true，且 SMTP 郵件伺服器不會在回應 EHLO 命令中公告 STARTTLS，則對 或 SendAsync 方法的呼叫Send會擲回 SmtpException。

Send(String, String, String, String)

來源:

SmtpClient.cs

傳送指定的電子郵件訊息給 SMTP 伺服器進行傳遞。 訊息寄件者、收件者、主旨和訊息主體是使用 String 物件來指定。

C#

public void Send (string from, string recipients, string? subject, string? body);

參數

from

String

String，包含訊息寄件者的地址資訊。

recipients

String

String，包含訊息要傳送到的地址。

subject

String

String，包含訊息的主旨行。

body

String

String，包含訊息主體。

例外狀況

ArgumentNullException

from 為 null。

-或-

recipients 為 null。

ArgumentException

from 為 Empty。

-或-

recipients 為 Empty。

InvalidOperationException

這 SmtpClient 有另一個已在進行中的傳送作業。

-或-

DeliveryMethod 屬性設定為 Network，且 Host 為 null。

-或-

DeliveryMethod 屬性設為 Network，且 Host 等於空字串 ("")。

-或-

DeliveryMethod 屬性設定為 Network ，而且 Port 為零、負數或大於 65,535。

ObjectDisposedException

這個物件已經過處置。

SmtpException

與 SMTP 伺服器的連接失敗。

-或-

驗證失敗。

-或-

作業逾時。

-或-

EnableSsl 設定為 true，但 DeliveryMethod 屬性設定為 SpecifiedPickupDirectory 或 PickupDirectoryFromIis。

-或-

EnableSsl 設為 true, 不過 SMTP 郵件伺服器並未在對 EHLO 命令的回應中通告 STARTTLS。

SmtpFailedRecipientException

無法將 message 傳遞給 To、CC 或 Bcc 中的一個收件者。

SmtpFailedRecipientsException

無法將 message 傳遞給 To、CC 或 Bcc 中的兩個或多個收件者。

備註

此方法會在傳送電子郵件時封鎖。 您可以使用 屬性指定逾時值 Timeout ，以確保方法會在經過指定的時間量之後傳回。

在呼叫此方法之前， Host 必須先透過組態檔來設定 和 Port 屬性，方法是設定相關屬性，或將此資訊傳遞至 SmtpClient(String, Int32) 建構函式。

如果訊息是以異步方式傳送，您就無法呼叫這個方法。

如果 SMTP 主機需要認證，您必須先設定認證，才能呼叫此方法。 若要指定認證，請使用 UseDefaultCredentials 或 Credentials 屬性。

如果您收到 SmtpException 例外狀況，請檢查 StatusCode 屬性以找出作業失敗的原因。 SmtpException也可以包含內部例外狀況，指出作業失敗的原因。

當使用 Send 傳送電子郵件給多個收件者，SMTP 伺服器接受某些收件者為有效，並拒絕其他收件者時， Send 會將電子郵件傳送給已接受的收件者，然後 SmtpFailedRecipientsException 擲回 (，如果 SmtpFailedRecipientException 只有一位收件者遭到拒絕，則會) 。 SmtpFailedRecipientsException包含拒絕的收件者清單。

注意

EnableSsl如果 屬性設定為true，且 SMTP 郵件伺服器不會在回應 EHLO 命令中公告 STARTTLS，則對 或 SendAsync 方法的呼叫Send會擲回 SmtpException。