SmtpClient.SendAsync Metoda

Definice

Obor názvů:: System.Net.Mail

Sestavení:: netstandard.dll, System.Net.Mail.dll

Sestavení:: System.Net.Mail.dll

Sestavení:: System.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Odešle e-mailovou zprávu. Tyto metody neblokují volající vlákno.

Přetížení

Name	Description
SendAsync(MailMessage, Object)	Odešle zadanou e-mailovou zprávu na server SMTP pro doručení. Tato metoda neblokuje volající vlákno a umožňuje volajícímu předat objekt metodě, která je vyvolána při dokončení operace.
SendAsync(String, String, String, String, Object)	Odešle e-mailovou zprávu na server SMTP pro doručení. Odesílatel zprávy, příjemci, předmět a text zprávy se zadají pomocí String objektů. Tato metoda neblokuje volající vlákno a umožňuje volajícímu předat objekt metodě, která je vyvolána při dokončení operace.

SendAsync(MailMessage, Object)

Zdroj:: SmtpClient.cs

Zdroj:: SmtpClient.cs

Zdroj:: SmtpClient.cs

Zdroj:: SmtpClient.cs

Zdroj:: SmtpClient.cs

Odešle zadanou e-mailovou zprávu na server SMTP pro doručení. Tato metoda neblokuje volající vlákno a umožňuje volajícímu předat objekt metodě, která je vyvolána při dokončení operace.

public:
 void SendAsync(System::Net::Mail::MailMessage ^ message, System::Object ^ userToken);

public void SendAsync(System.Net.Mail.MailMessage message, object? userToken);

public void SendAsync(System.Net.Mail.MailMessage message, object userToken);

member this.SendAsync : System.Net.Mail.MailMessage * obj -> unit

Public Sub SendAsync (message As MailMessage, userToken As Object)

Parametry

message: MailMessage

A MailMessage obsahující zprávu, která se má odeslat.

userToken: Object

Uživatelem definovaný objekt, který se předá metodě vyvolá při dokončení asynchronní operace.

Výjimky

ArgumentNullException

message je null.

nebo

From je null.

InvalidOperationException

Tato SmtpClient operace odesílání už probíhá.

nebo

Nejsou zadáni To CCžádní příjemci , a Bcc vlastnosti.

nebo

DeliveryMethod vlastnost je nastavena Network a Host je null.

nebo

DeliveryMethod vlastnost je nastavena Network a Host je rovna prázdnému řetězci ("").

nebo

DeliveryMethod vlastnost je nastavena Network na hodnotu nula Port , záporné číslo nebo větší než 65 535.

ObjectDisposedException

Tento objekt byl odstraněn.

SmtpException

Připojení k serveru SMTP se nezdařilo.

nebo

Ověření se nezdařilo.

nebo

Vypršel časový limit operace.

nebo

EnableSsl je nastavena na true hodnotu, ale vlastnost je nastavena DeliveryMethod na SpecifiedPickupDirectory hodnotu nebo PickupDirectoryFromIis.

nebo

EnableSsl je nastavena na true, , ale poštovní server SMTP neinzeroval funkci STARTTLS v odpovědi na příkaz EHLO.

nebo

Nelze message doručit jednomu nebo více příjemcům v Tosouboru , CCnebo Bcc.

SmtpFailedRecipientException

message Nebylo možné doručit některému z příjemců v To, CCnebo Bcc.

SmtpFailedRecipientsException

Nelze message doručit dvěma nebo více příjemcům v To, CCnebo Bcc.

Příklady

Následující příklad kódu ukazuje volání této metody.


using System;
using System.Net;
using System.Net.Mail;
using System.Net.Mime;
using System.Threading;
using System.ComponentModel;
namespace Examples.SmtpExamples.Async
{
    public class SimpleAsynchronousExample
    {
        static bool mailSent = false;
        private static void SendCompletedCallback(object sender, AsyncCompletedEventArgs e)
        {
            // Get the unique identifier for this asynchronous operation.
             String token = (string) e.UserState;

            if (e.Cancelled)
            {
                 Console.WriteLine("[{0}] Send canceled.", token);
            }
            if (e.Error != null)
            {
                 Console.WriteLine("[{0}] {1}", token, e.Error.ToString());
            } else
            {
                Console.WriteLine("Message sent.");
            }
            mailSent = true;
        }
        public static void Main(string[] args)
        {
            // Command-line argument must be the SMTP host.
            SmtpClient client = new SmtpClient(args[0]);
            // Specify the email sender.
            // Create a mailing address that includes a UTF8 character
            // in the display name.
            MailAddress from = new MailAddress("jane@contoso.com",
               "Jane " + (char)0xD8+ " Clayton",
            System.Text.Encoding.UTF8);
            // Set destinations for the email message.
            MailAddress to = new MailAddress("ben@contoso.com");
            // Specify the message content.
            MailMessage message = new MailMessage(from, to);
            message.Body = "This is a test email message sent by an application. ";
            // Include some non-ASCII characters in body and subject.
            string someArrows = new string(new char[] {'\u2190', '\u2191', '\u2192', '\u2193'});
            message.Body += Environment.NewLine + someArrows;
            message.BodyEncoding =  System.Text.Encoding.UTF8;
            message.Subject = "test message 1" + someArrows;
            message.SubjectEncoding = System.Text.Encoding.UTF8;
            // Set the method that is called back when the send operation ends.
            client.SendCompleted += new
            SendCompletedEventHandler(SendCompletedCallback);
            // The userState can be any object that allows your callback
            // method to identify this send operation.
            // For this example, the userToken is a string constant.
            string userState = "test message1";
            client.SendAsync(message, userState);
            Console.WriteLine("Sending message... press c to cancel mail. Press any other key to exit.");
            string answer = Console.ReadLine();
            // If the user canceled the send, and mail hasn't been sent yet,
            // then cancel the pending operation.
            if (answer.StartsWith("c") && !mailSent)
            {
                client.SendAsyncCancel();
            }
            // Clean up.
            message.Dispose();
            client.Dispose();
            Console.WriteLine("Goodbye.");
        }
    }
}


Imports System.Net
Imports System.Net.Mail
Imports System.Net.Mime
Imports System.Threading
Imports System.ComponentModel

Namespace Examples.SmtpExamples.Async
    Public Class SimpleAsynchronousExample
        Private Shared mailSent As Boolean = False
        Private Shared Sub SendCompletedCallback(ByVal sender As Object, ByVal e As AsyncCompletedEventArgs)
            ' Get the unique identifier for this asynchronous operation.
            Dim token As String = CStr(e.UserState)

            If e.Cancelled Then
                Console.WriteLine("[{0}] Send canceled.", token)
            End If
            If e.Error IsNot Nothing Then
                Console.WriteLine("[{0}] {1}", token, e.Error.ToString())
            Else
                Console.WriteLine("Message sent.")
            End If
            mailSent = True
        End Sub
        Public Shared Sub Main(ByVal args() As String)
            ' Command line argument must the SMTP host.
            Dim client As New SmtpClient(args(0))
            ' Specify the email sender.
            ' Create a mailing address that includes a UTF8 character
            ' in the display name.
            Dim mailFrom As New MailAddress("jane@contoso.com", "Jane " & ChrW(&HD8) & " Clayton", System.Text.Encoding.UTF8)
            ' Set destinations for the email message.
            Dim mailTo As New MailAddress("ben@contoso.com")
            ' Specify the message content.
            Dim message As New MailMessage(mailFrom, mailTo)
            message.Body = "This is a test email message sent by an application. "
            ' Include some non-ASCII characters in body and subject.
            Dim someArrows As New String(New Char() {ChrW(&H2190), ChrW(&H2191), ChrW(&H2192), ChrW(&H2193)})
            message.Body += Environment.NewLine & someArrows
            message.BodyEncoding = System.Text.Encoding.UTF8
            message.Subject = "test message 1" & someArrows
            message.SubjectEncoding = System.Text.Encoding.UTF8
            ' Set the method that is called back when the send operation ends.
            AddHandler client.SendCompleted, AddressOf SendCompletedCallback
            ' The userState can be any object that allows your callback 
            ' method to identify this send operation.
            ' For this example, the userToken is a string constant.
            Dim userState As String = "test message1"
            client.SendAsync(message, userState)
            Console.WriteLine("Sending message... press c to cancel mail. Press any other key to exit.")
            Dim answer As String = Console.ReadLine()
            ' If the user canceled the send, and mail hasn't been sent yet,
            ' then cancel the pending operation.
            If answer.StartsWith("c") AndAlso mailSent = False Then
                client.SendAsyncCancel()
            End If
            ' Clean up.
            message.Dispose()
            client.Dispose()
            Console.WriteLine("Goodbye.")
        End Sub
    End Class
End Namespace

Poznámky

Pokud chcete dostávat oznámení o odeslání e-mailu nebo byla operace zrušena, přidejte do události obslužnou rutinu SendCompleted události. Operaci můžete zrušit SendAsync voláním SendAsyncCancel metody.

Po volání SendAsyncmusíte počkat na dokončení přenosu e-mailu, než se pokusíte odeslat jinou e-mailovou zprávu pomocí Send nebo SendAsync.

Před voláním této metody musí Host Port být a musí být nastaveny prostřednictvím konfiguračních souborů nastavením relevantních vlastností nebo předáním těchto informací do konstruktoru SmtpClient(String, Int32) .

Pokud hostitel SMTP vyžaduje přihlašovací údaje, musíte je nastavit před voláním této metody. K zadání přihlašovacích údajů použijte vlastnostiUseDefaultCredentials.Credentials

Pokud se zobrazí SmtpException výjimka, zkontrolujte vlastnost a vyhledejte StatusCode důvod selhání operace. Může SmtpException také obsahovat vnitřní výjimku, která označuje důvod, proč operace selhala.

Když posíláte e-maily více SendAsync příjemcům, pokud server SMTP přijme některé příjemce jako platné a odmítne jiné, SmtpException vyvolá se NullReferenceException vnitřní výjimka. Pokud k tomu dojde, SendAsync nepošle e-mail žádnému z příjemců.

Aplikace může zjistit chybu ověření certifikátu serveru prozkoumáním Error vlastnosti předané delegátu SendCompletedEventHandler .

Vlastnost Timeout nemá žádný vliv na SendAsync volání.

Chcete-li odesílat poštu a blokovat při přenosu na server SMTP, použijte jednu z Send metod.

Poznámka:

Pokud je vlastnost nastavena EnableSsl na truea SMTP poštovní server neinzeruje STARTTLS v reakci na příkaz EHLO, volání Send metody nebo SendAsync metody vyvolá SmtpException.

Platí pro

SendAsync(String, String, String, String, Object)

Zdroj:: SmtpClient.cs

Zdroj:: SmtpClient.cs

Zdroj:: SmtpClient.cs

Zdroj:: SmtpClient.cs

Zdroj:: SmtpClient.cs

Odešle e-mailovou zprávu na server SMTP pro doručení. Odesílatel zprávy, příjemci, předmět a text zprávy se zadají pomocí String objektů. Tato metoda neblokuje volající vlákno a umožňuje volajícímu předat objekt metodě, která je vyvolána při dokončení operace.

public:
 void SendAsync(System::String ^ from, System::String ^ recipients, System::String ^ subject, System::String ^ body, System::Object ^ userToken);

public void SendAsync(string from, string recipients, string? subject, string? body, object? userToken);

public void SendAsync(string from, string recipients, string subject, string body, object userToken);

member this.SendAsync : string * string * string * string * obj -> unit

Public Sub SendAsync (from As String, recipients As String, subject As String, body As String, userToken As Object)

Parametry

from: String

A String obsahující informace o adrese odesílatele zprávy.

recipients: String

A String obsahující adresu, na kterou je zpráva odeslána.

subject: String

A String obsahující řádek předmětu zprávy.

body: String

A String obsahující text zprávy.

userToken: Object

Uživatelem definovaný objekt, který se předá metodě vyvolá při dokončení asynchronní operace.

Výjimky

ArgumentNullException

from je null.

nebo

recipients je null.

ArgumentException

from je Empty.

nebo

recipients je Empty.

InvalidOperationException

SendAsync Probíhá SmtpClient volání.

nebo

DeliveryMethod vlastnost je nastavena Network a Host je null.

nebo

DeliveryMethod vlastnost je nastavena Network a Host je rovna prázdnému řetězci ("").

nebo

DeliveryMethod vlastnost je nastavena Network na hodnotu nula Port , záporné číslo nebo větší než 65 535.

ObjectDisposedException

Tento objekt byl odstraněn.

SmtpException

Připojení k serveru SMTP se nezdařilo.

nebo

Ověření se nezdařilo.

nebo

Vypršel časový limit operace.

nebo

EnableSsl je nastavena na true hodnotu, ale vlastnost je nastavena DeliveryMethod na SpecifiedPickupDirectory hodnotu nebo PickupDirectoryFromIis.

nebo

EnableSsl je nastavena na true, , ale poštovní server SMTP neinzeroval funkci STARTTLS v odpovědi na příkaz EHLO.

nebo

Zprávu nelze doručit jednomu nebo více příjemcům v recipientssouboru .

SmtpFailedRecipientException

Zprávu nelze doručit jednomu z příjemců v Tosouboru , CCnebo Bcc.

SmtpFailedRecipientsException

Zprávu nelze doručit dvěma nebo více příjemcům v Tosouboru , CCnebo Bcc.

Poznámky

Po volání SendAsyncmusíte počkat na dokončení přenosu e-mailu, než se pokusíte odeslat jinou e-mailovou zprávu pomocí Send nebo SendAsync.

Před voláním této metody Host musí být vlastnosti Port nastaveny buď prostřednictvím konfiguračních souborů, nebo nastavením vlastností nebo předáním těchto informací do konstruktoru SmtpClient(String, Int32) .

Pokud hostitel SMTP vyžaduje přihlašovací údaje, musíte je nastavit před voláním této metody. K zadání přihlašovacích údajů použijte UseDefaultCredentials vlastnost nebo Credentials vlastnost.

Aplikace může zjistit chybu ověření certifikátu serveru prozkoumáním Error vlastnosti předané delegátu SendCompletedEventHandler .

Vlastnost Timeout nemá žádný vliv na SendAsync volání.

Chcete-li odesílat poštu a blokovat při přenosu na server SMTP, použijte jednu z Send metod.

Poznámka:

Pokud je vlastnost nastavena EnableSsl na truea SMTP poštovní server neinzeruje STARTTLS v reakci na příkaz EHLO, volání Send metody nebo SendAsync metody vyvolá SmtpException.

Platí pro

Váš názor

Byla tato stránka užitečná?

Sdílet prostřednictvím

SmtpClient.SendAsync Metoda

Definice

Přetížení

SendAsync(MailMessage, Object)

Parametry

Výjimky

Příklady

Poznámky

Platí pro

SendAsync(String, String, String, String, Object)

Parametry

Výjimky

Poznámky

Platí pro

Váš názor