SmtpClient.Send Метод

Ссылка

Определение

Пространство имен:: System.Net.Mail

Сборка:: System.Net.Mail.dll

Сборка:: System.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Отправляет сообщение электронной почты на сервер SMTP для доставки. Эти методы блокируются во время передачи сообщения.

Перегрузки

Send(MailMessage)	Отправляет указанное сообщение на сервер SMTP для доставки.
Send(String, String, String, String)	Отправляет указанное сообщение электронной почты на сервер SMTP для доставки. Отправитель, получатели, тема и основная часть сообщения указываются с помощью объектов String.

Send(MailMessage)

Исходный код:: SmtpClient.cs

Исходный код:: SmtpClient.cs

Исходный код:: SmtpClient.cs

Отправляет указанное сообщение на сервер SMTP для доставки.

public:
 void Send(System::Net::Mail::MailMessage ^ message);

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

member this.Send : System.Net.Mail.MailMessage -> unit

Public Sub Send (message As MailMessage)

Параметры

message: MailMessage

Объект MailMessage, который содержит отправляемое сообщение.

Исключения

ArgumentNullException

message имеет значение null.

InvalidOperationException

В этом SmtpClient случае уже выполняется другая операция отправки.

-или-

From имеет значение null.

-или-

Отсутствуют получатели в свойствах To, CC и Bcc.

-или-

Свойству DeliveryMethod задано значение Network, а свойству Host задано значение null.

-или-

Свойству DeliveryMethod задано значение Network и Host равно пустой строке ("").

-или-

Свойство DeliveryMethod имеет значение Network, а свойство Port равно нулю, отрицательно или больше 65535.

ObjectDisposedException

Данный объект удален.

SmtpException

Сбой подключения к серверу SMTP.

-или-

Проверка подлинности не пройдена.

-или-

Истекло время ожидания для выполнения операции.

-или-

EnableSsl имеет значение true, а свойство DeliveryMethod имеет значение SpecifiedPickupDirectory или PickupDirectoryFromIis.

-или-

Свойство EnableSsl имеет значение true, однако почтовый SMTP-сервер не отправил STARTTLS в ответ на команду EHLO.

SmtpFailedRecipientException

Сообщение message не удалось доставить одному из получателей To, CC или Bcc.

SmtpFailedRecipientsException

Сообщение message не удалось доставить двум или более получателям To, CC или Bcc.

Примеры

В следующем примере кода показано использование этого метода.

static void CreateTestMessage2( String^ server )
{
   String^ to = L"jane@contoso.com";
   String^ from = L"ben@contoso.com";
   MailMessage^ message = gcnew MailMessage( from,to );
   message->Subject = L"Using the new SMTP client.";
   message->Body = L"Using this new feature, you can send an email message from an application very easily.";
   SmtpClient^ client = gcnew 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;
   client->Send( message );
   client->~SmtpClient();
}

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 не объявляет STARTTLS в ответе на команду EHLO, то вызов Send методов или SendAsync вызовет исключение SmtpException.

Применяется к

Send(String, String, String, String)

Исходный код:: SmtpClient.cs

Исходный код:: SmtpClient.cs

Исходный код:: SmtpClient.cs

Отправляет указанное сообщение электронной почты на сервер SMTP для доставки. Отправитель, получатели, тема и основная часть сообщения указываются с помощью объектов String.

public:
 void Send(System::String ^ from, System::String ^ recipients, System::String ^ subject, System::String ^ body);

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

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

member this.Send : string * string * string * string -> unit

Public Sub Send (from As String, recipients As String, subject As String, body As String)

Параметры

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 равно нулю, отрицательно или больше 65535.

ObjectDisposedException

Данный объект удален.

SmtpException

Сбой подключения к серверу SMTP.

-или-

Проверка подлинности не пройдена.

-или-

Истекло время ожидания для выполнения операции.

-или-

EnableSsl имеет значение true, а свойство DeliveryMethod имеет значение SpecifiedPickupDirectory или PickupDirectoryFromIis.

-или-

Свойство EnableSsl имеет значение true, однако почтовый SMTP-сервер не отправил STARTTLS в ответ на команду EHLO.

SmtpFailedRecipientException

Сообщение message не удалось доставить одному из получателей To, CC или Bcc.

SmtpFailedRecipientsException

Сообщение message не удалось доставить двум или более получателям To, CC или Bcc.

Применяется к

SmtpClient.Send Метод

Определение

Перегрузки

Send(MailMessage)

Параметры

Исключения

Примеры

Комментарии

Применяется к

Send(String, String, String, String)

Параметры

Исключения

Комментарии

Применяется к

Обратная связь

Дополнительные ресурсы