Freigeben über


SmtpClient.SendMailAsync Methode

Definition

Sendet die angegebene Meldung an einen SMTP-Server für die Übermittlung als asynchroner Vorgang.

Überlädt

SendMailAsync(MailMessage)

Sendet die angegebene Meldung an einen SMTP-Server für die Übermittlung als asynchroner Vorgang.

SendMailAsync(MailMessage, CancellationToken)

Sendet die angegebene Meldung an einen SMTP-Server für die Übermittlung als asynchroner Vorgang.

SendMailAsync(String, String, String, String)

Sendet die angegebene Meldung an einen SMTP-Server für die Übermittlung als asynchroner Vorgang. Der Absender, die Empfänger, der Betreff und der Text der Nachricht werden mit String-Objekten angegeben.

SendMailAsync(String, String, String, String, CancellationToken)

Sendet die angegebene Nachricht unter Verwendung der angegebenen Absender-, Empfänger-, Betreffzeilen- und Textzeichenfolgen an einen SMTP-Server zur Übermittlung als asynchroner Vorgang.

SendMailAsync(MailMessage)

Quelle:
SmtpClient.cs
Quelle:
SmtpClient.cs
Quelle:
SmtpClient.cs

Sendet die angegebene Meldung an einen SMTP-Server für die Übermittlung als asynchroner Vorgang.

public:
 System::Threading::Tasks::Task ^ SendMailAsync(System::Net::Mail::MailMessage ^ message);
public System.Threading.Tasks.Task SendMailAsync (System.Net.Mail.MailMessage message);
member this.SendMailAsync : System.Net.Mail.MailMessage -> System.Threading.Tasks.Task
Public Function SendMailAsync (message As MailMessage) As Task

Parameter

message
MailMessage

Eine MailMessage, die die zu sendende Nachricht enthält.

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

message ist null

Ein SmtpClient weiterer Sendevorgang wird bereits ausgeführt.

- oder -

In den Eigenschaften To, CC und Bcc sind keine Empfänger angegeben.

- oder -

Die DeliveryMethod-Eigenschaft ist auf Network festgelegt, und Host ist null.

- oder -

Die DeliveryMethod-Eigenschaft ist auf Network festgelegt, und Host ist gleich der leeren Zeichenfolge ("").

- oder -

DeliveryMethod-Eigenschaft wird auf Network festgelegt, und Port ist 0 (null), eine negative Zahl oder größer als 65,535.

Dieses Objekt wurde verworfen.

Die Verbindung mit dem SMTP-Server ist fehlgeschlagen.

- oder -

Fehler bei der Authentifizierung.

- oder -

Timeout für den Vorgang.

- oder -

EnableSsl ist auf true festgelegt, die DeliveryMethod-Eigenschaft ist jedoch auf SpecifiedPickupDirectory oder PickupDirectoryFromIis festgelegt.

- oder -

EnableSsl wird auf true, festgelegt, aber der SMTP-E-Mail-Server hat nicht STARTTLS in der Antwort auf den EHLO-Befehl angeboten.

- oder -

Die message konnte an einen oder mehrere Empfänger in To, CC oder Bcc nicht übermittelt werden.

Die message konnte an einen der Empfänger in To, CC oder Bcc nicht übermittelt werden.

Die message konnte an mindestens zwei Empfänger in To, CC oder Bcc nicht übermittelt werden.

Hinweise

Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task Objekt wird abgeschlossen, sobald die Nachricht gesendet wurde.

Gilt für:

SendMailAsync(MailMessage, CancellationToken)

Quelle:
SmtpClient.cs
Quelle:
SmtpClient.cs
Quelle:
SmtpClient.cs

Sendet die angegebene Meldung an einen SMTP-Server für die Übermittlung als asynchroner Vorgang.

public:
 System::Threading::Tasks::Task ^ SendMailAsync(System::Net::Mail::MailMessage ^ message, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task SendMailAsync (System.Net.Mail.MailMessage message, System.Threading.CancellationToken cancellationToken);
member this.SendMailAsync : System.Net.Mail.MailMessage * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function SendMailAsync (message As MailMessage, cancellationToken As CancellationToken) As Task

Parameter

message
MailMessage

Die zu sendende Meldung.

cancellationToken
CancellationToken

Das Abbruchtoken, um den Vorgang abzubrechen.

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

message ist null

Ein SmtpClient weiterer Sendevorgang wird bereits ausgeführt.

- oder -

From ist null.

- oder -

In den Eigenschaften To, CC und Bcc sind keine Empfänger angegeben.

- oder -

Die DeliveryMethod-Eigenschaft ist auf Network festgelegt, und Host ist null.

- oder -

Die DeliveryMethod-Eigenschaft ist auf Network festgelegt, und Host ist gleich der leeren Zeichenfolge ("").

- oder -

DeliveryMethod-Eigenschaft wird auf Network festgelegt, und Port ist 0 (null), eine negative Zahl oder größer als 65,535.

Dieses Objekt wurde verworfen.

Die Verbindung mit dem SMTP-Server ist fehlgeschlagen.

- oder -

Fehler bei der Authentifizierung.

- oder -

Timeout für den Vorgang.

- oder -

EnableSsl ist auf true festgelegt, die DeliveryMethod-Eigenschaft ist jedoch auf SpecifiedPickupDirectory oder PickupDirectoryFromIis festgelegt.

- oder -

EnableSsl wird auf true, festgelegt, aber der SMTP-E-Mail-Server hat nicht STARTTLS in der Antwort auf den EHLO-Befehl angeboten.

- oder -

Die message konnte an einen oder mehrere Empfänger in To, CC oder Bcc nicht übermittelt werden.

Die message konnte an einen der Empfänger in To, CC oder Bcc nicht übermittelt werden.

Die message konnte an mindestens zwei Empfänger in To, CC oder Bcc nicht übermittelt werden.

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task Objekt wird abgeschlossen, sobald die Nachricht gesendet wurde.

Gilt für:

SendMailAsync(String, String, String, String)

Quelle:
SmtpClient.cs
Quelle:
SmtpClient.cs
Quelle:
SmtpClient.cs

Sendet die angegebene Meldung an einen SMTP-Server für die Übermittlung als asynchroner Vorgang. Der Absender, die Empfänger, der Betreff und der Text der Nachricht werden mit String-Objekten angegeben.

public:
 System::Threading::Tasks::Task ^ SendMailAsync(System::String ^ from, System::String ^ recipients, System::String ^ subject, System::String ^ body);
public System.Threading.Tasks.Task SendMailAsync (string from, string recipients, string? subject, string? body);
public System.Threading.Tasks.Task SendMailAsync (string from, string recipients, string subject, string body);
member this.SendMailAsync : string * string * string * string -> System.Threading.Tasks.Task
Public Function SendMailAsync (from As String, recipients As String, subject As String, body As String) As Task

Parameter

from
String

Ein String, der die Adressinformationen des Absenders der Nachricht enthält.

recipients
String

Ein String, der die Adressen enthält, an die die Nachricht gesendet wird.

subject
String

Ein String, der die Betreffzeile für die Nachricht enthält.

body
String

Ein String, der den Nachrichtentext enthält.

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

from ist null.

- oder -

recipients ist null.

from ist Empty.

- oder -

recipients ist Empty.

Ein SmtpClient weiterer Sendevorgang wird bereits ausgeführt.

- oder -

From ist null.

- oder -

Die DeliveryMethod-Eigenschaft ist auf Network festgelegt, und Host ist null.

- oder -

Die DeliveryMethod-Eigenschaft ist auf Network festgelegt, und Host ist gleich der leeren Zeichenfolge ("").

- oder -

DeliveryMethod-Eigenschaft wird auf Network festgelegt, und Port ist 0 (null), eine negative Zahl oder größer als 65,535.

Dieses Objekt wurde verworfen.

Die Verbindung mit dem SMTP-Server ist fehlgeschlagen.

- oder -

Fehler bei der Authentifizierung.

- oder -

Timeout für den Vorgang.

- oder -

EnableSsl ist auf true festgelegt, die DeliveryMethod-Eigenschaft ist jedoch auf SpecifiedPickupDirectory oder PickupDirectoryFromIis festgelegt.

- oder -

EnableSsl wird auf true, festgelegt, aber der SMTP-E-Mail-Server hat nicht STARTTLS in der Antwort auf den EHLO-Befehl angeboten.

- oder -

Die message konnte an einen oder mehrere Empfänger in To, CC oder Bcc nicht übermittelt werden.

Die message konnte an einen der Empfänger in To, CC oder Bcc nicht übermittelt werden.

Die message konnte an mindestens zwei Empfänger in To, CC oder Bcc nicht übermittelt werden.

Hinweise

Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task Objekt wird abgeschlossen, sobald die Nachricht gesendet wurde.

Gilt für:

SendMailAsync(String, String, String, String, CancellationToken)

Quelle:
SmtpClient.cs
Quelle:
SmtpClient.cs
Quelle:
SmtpClient.cs

Sendet die angegebene Nachricht unter Verwendung der angegebenen Absender-, Empfänger-, Betreffzeilen- und Textzeichenfolgen an einen SMTP-Server zur Übermittlung als asynchroner Vorgang.

public:
 System::Threading::Tasks::Task ^ SendMailAsync(System::String ^ from, System::String ^ recipients, System::String ^ subject, System::String ^ body, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task SendMailAsync (string from, string recipients, string? subject, string? body, System.Threading.CancellationToken cancellationToken);
member this.SendMailAsync : string * string * string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function SendMailAsync (from As String, recipients As String, subject As String, body As String, cancellationToken As CancellationToken) As Task

Parameter

from
String

Die Adressinformationen des Absenders der Nachricht.

recipients
String

Die Adressen, an die die Nachricht gesendet wird.

subject
String

Die Betreffzeile für die Nachricht.

body
String

Der Nachrichtentext.

cancellationToken
CancellationToken

Das Abbruchtoken, um den Vorgang abzubrechen.

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

from ist null.

- oder -

recipients ist null.

from ist Empty.

- oder -

recipients ist Empty.

Ein SmtpClient weiterer Sendevorgang wird bereits ausgeführt.

- oder -

Die DeliveryMethod-Eigenschaft ist auf Network festgelegt, und Host ist null.

- oder -

Die DeliveryMethod-Eigenschaft ist auf Network festgelegt, und Host ist gleich der leeren Zeichenfolge ("").

- oder -

DeliveryMethod-Eigenschaft wird auf Network festgelegt, und Port ist 0 (null), eine negative Zahl oder größer als 65,535.

Dieses Objekt wurde verworfen.

Die Verbindung mit dem SMTP-Server ist fehlgeschlagen.

- oder -

Fehler bei der Authentifizierung.

- oder -

Timeout für den Vorgang.

- oder -

EnableSsl ist auf true festgelegt, die DeliveryMethod-Eigenschaft ist jedoch auf SpecifiedPickupDirectory oder PickupDirectoryFromIis festgelegt.

- oder -

EnableSsl wird auf true, festgelegt, aber der SMTP-E-Mail-Server hat nicht STARTTLS in der Antwort auf den EHLO-Befehl angeboten.

- oder -

Die message konnte an einen oder mehrere Empfänger in To, CC oder Bcc nicht übermittelt werden.

Die message konnte an einen der Empfänger in To, CC oder Bcc nicht übermittelt werden.

Die message konnte an mindestens zwei Empfänger in To, CC oder Bcc nicht übermittelt werden.

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task Objekt wird abgeschlossen, sobald die Nachricht gesendet wurde.

Gilt für: