SmtpClient.Send SmtpClient.Send SmtpClient.Send SmtpClient.Send Method

Definition

Sendet eine E-Mail für die Übermittlung an einen SMTP-Server.Sends an email message to an SMTP server for delivery. Diese Methoden werden während der Übertragung der Nachricht blockiert.These methods block while the message is being transmitted.

Überlädt

Send(MailMessage) Send(MailMessage) Send(MailMessage) Send(MailMessage)

Sendet die angegebene Nachricht an einen SMTP-Server für die Übermittlung.Sends the specified message to an SMTP server for delivery.

Send(String, String, String, String) Send(String, String, String, String) Send(String, String, String, String) Send(String, String, String, String)

Sendet die angegebene E-Mail für die Übermittlung an einen SMTP-Server.Sends the specified email message to an SMTP server for delivery. Der Absender, die Empfänger, der Betreff und der Text der Nachricht werden mit String-Objekten angegeben.The message sender, recipients, subject, and message body are specified using String objects.

Send(MailMessage) Send(MailMessage) Send(MailMessage) Send(MailMessage)

Sendet die angegebene Nachricht an einen SMTP-Server für die Übermittlung.Sends the specified message to an SMTP server for delivery.

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)

Parameter

message
MailMessage MailMessage MailMessage MailMessage

Eine MailMessage, die die zu sendende Nachricht enthält.A MailMessage that contains the message to send.

Ausnahmen

Für diesen SmtpClient wird gerade ein SendAsync-Aufruf ausgeführt.This SmtpClient has a SendAsync call in progress.

- oder --or- From ist null.From is null.

- oder --or- In den Eigenschaften To, CC und Bcc sind keine Empfänger angegeben.There are no recipients specified in To, CC, and Bcc properties.

- oder --or- Die DeliveryMethod-Eigenschaft ist auf Network festgelegt, und Host ist null.DeliveryMethod property is set to Network and Host is null.

- oder --or- Die DeliveryMethod-Eigenschaft ist auf Network festgelegt, und Host ist gleich der leeren Zeichenfolge ("").DeliveryMethod property is set to Network and Host is equal to the empty string ("").

- oder --or- DeliveryMethod-Eigenschaft wird auf Network festgelegt, und Port ist 0 (null), eine negative Zahl oder größer als 65,535.DeliveryMethod property is set to Network and Port is zero, a negative number, or greater than 65,535.

Dieses Objekt wurde verworfen.This object has been disposed.

Die Verbindung mit dem SMTP-Server ist fehlgeschlagen.The connection to the SMTP server failed.

- oder --or- Fehler bei der Authentifizierung.Authentication failed.

- oder --or- Timeout für den Vorgang.The operation timed out. - oder --or- EnableSsl ist auf true festgelegt, die DeliveryMethod-Eigenschaft ist jedoch auf SpecifiedPickupDirectory oder PickupDirectoryFromIis festgelegt.EnableSsl is set to true but the DeliveryMethod property is set to SpecifiedPickupDirectory or PickupDirectoryFromIis.

- oder --or- EnableSsl wird auf true, festgelegt, aber der SMTP-E-Mail-Server hat nicht STARTTLS in der Antwort auf den EHLO-Befehl angeboten.EnableSsl is set to true, but the SMTP mail server did not advertise STARTTLS in the response to the EHLO command.

Die message konnte an einen der Empfänger in To, CC oder Bcc nicht übermittelt werden.The message could not be delivered to one of the recipients in To, CC, or Bcc.

Die message konnte an mindestens zwei Empfänger in To, CC oder Bcc nicht übermittelt werden.The message could not be delivered to two or more of the recipients in To, CC, or Bcc.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, mit dieser Methode.The following code example demonstrates using this method.

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() );			  
    }              
}

Hinweise

Diese Methode blockiert, während der Übertragung der e-Mails.This method blocks while the email is transmitted. Sie können angeben, ein Timeout-Wert mithilfe der Timeout Eigenschaft, um sicherzustellen, dass die Methode, nach einem angegebenen Zeitraum abgelaufen ist zurückgibt.You can specify a time-out value using the Timeout property to ensure that the method returns after a specified amount of time elapses.

Vor dem Aufrufen dieser Methode die Host und Port Eigenschaften müssen festgelegt werden entweder über die Konfigurationsdateien durch Festlegen der relevanten Eigenschaften oder durch Übergeben dieser Informationen in den SmtpClient(String, Int32) Konstruktor.Before calling this method, the Host and Port properties must be set either through the configuration files by setting the relevant properties, or by passing this information into the SmtpClient(String, Int32) constructor.

Sie können nicht diese Methode aufrufen, wenn eine Nachricht asynchron gesendet werden.You cannot call this method if there is a message being sent asynchronously.

Wenn der SMTP-Host Anmeldeinformationen erfordert, müssen Sie diese vor dem Aufrufen dieser Methode festlegen.If the SMTP host requires credentials, you must set them before calling this method. Verwenden Sie zum Angeben der Anmeldeinformationen der UseDefaultCredentials oder Credentials Eigenschaften.To specify credentials, use the UseDefaultCredentials or Credentials properties.

Wenn Sie erhalten ein SmtpException Ausnahme Überprüfen der StatusCode Eigenschaft, um festzustellen, was den Vorgang ist fehlgeschlagen.If you receive an SmtpException exception, check the StatusCode property to find the reason the operation failed. Die SmtpException kann auch eine innere Ausnahme, die gibt den Grund Fehler bei Vorgang enthalten.The SmtpException can also contain an inner exception that indicates the reason the operation failed.

Beim Senden von e-Mails unter Verwendung Send an mehrere Empfänger und die SMTP-Server einige Empfänger als gültig akzeptiert, und lehnt Sie ab, die andere Send sendet eine e-Mail an die Empfänger akzeptiert und dann eine SmtpFailedRecipientsException wird ausgelöst, (oder ein SmtpFailedRecipientException nur eine Empfänger abgelehnt).When sending email using Send to multiple recipients and the SMTP server accepts some recipients as valid and rejects others, Send sends email to the accepted recipients and then a SmtpFailedRecipientsException is thrown (or a SmtpFailedRecipientException if only one recipient is rejected). Ein SmtpFailedRecipientsException enthält eine Liste der Empfänger, die abgelehnt wurden.A SmtpFailedRecipientsException contains a list of the recipients that were rejected.

Hinweis

Wenn die EnableSsl -Eigenschaftensatz auf true, und die SMTP-Mailserver wirbt nicht STARTTLS in der Antwort auf den EHLO Befehl klicken Sie dann einen Aufruf der Send oder SendAsync Methoden lösen eine SmtpException.If the EnableSsl property is set to true, and the SMTP mail server does not advertise STARTTLS in the response to the EHLO command, then a call to the Send or SendAsync methods will throw an SmtpException.

Sicherheit

SmtpPermission
Die Verbindung zum SMTP-Server.to connect to the SMTP server. Zugeordnete Enumeration: ConnectAssociated enumeration: Connect

Send(String, String, String, String) Send(String, String, String, String) Send(String, String, String, String) Send(String, String, String, String)

Sendet die angegebene E-Mail für die Übermittlung an einen SMTP-Server.Sends the specified email message to an SMTP server for delivery. Der Absender, die Empfänger, der Betreff und der Text der Nachricht werden mit String-Objekten angegeben.The message sender, recipients, subject, and message body are specified using String objects.

public:
 void Send(System::String ^ from, System::String ^ to, System::String ^ subject, System::String ^ body);
public void Send (string from, string to, string subject, string body);
member this.Send : string * string * string * string -> unit
Public Sub Send (from As String, to As String, subject As String, body As String)

Parameter

from
String String String String

Ein String, der die Adressinformationen des Absenders der Nachricht enthält.A String that contains the address information of the message sender.

recipients
String String String String

Ein String, der die Adressen enthält, an die die Nachricht gesendet wird.A String that contains the addresses that the message is sent to.

subject
String String String String

Ein String, der die Betreffzeile für die Nachricht enthält.A String that contains the subject line for the message.

body
String String String String

Ein String, der den Nachrichtentext enthält.A String that contains the message body.

Ausnahmen

from ist null.from is null.

- oder --or- recipients ist null.recipients is null.

from ist Empty.from is Empty.

- oder --or- recipients ist Empty.recipients is Empty.

Für diesen SmtpClient wird gerade ein SendAsync-Aufruf ausgeführt.This SmtpClient has a SendAsync call in progress.

- oder --or- Die DeliveryMethod-Eigenschaft ist auf Network festgelegt, und Host ist null.DeliveryMethod property is set to Network and Host is null.

- oder --or- Die DeliveryMethod-Eigenschaft ist auf Network festgelegt, und Host ist gleich der leeren Zeichenfolge ("").DeliveryMethod property is set to Network and Host is equal to the empty string ("").

- oder --or- DeliveryMethod-Eigenschaft wird auf Network festgelegt, und Port ist 0 (null), eine negative Zahl oder größer als 65,535.DeliveryMethod property is set to Network and Port is zero, a negative number, or greater than 65,535.

Dieses Objekt wurde verworfen.This object has been disposed.

Die Verbindung mit dem SMTP-Server ist fehlgeschlagen.The connection to the SMTP server failed.

- oder --or- Fehler bei der Authentifizierung.Authentication failed.

- oder --or- Timeout für den Vorgang.The operation timed out. - oder --or- EnableSsl ist auf true festgelegt, die DeliveryMethod-Eigenschaft ist jedoch auf SpecifiedPickupDirectory oder PickupDirectoryFromIis festgelegt.EnableSsl is set to true but the DeliveryMethod property is set to SpecifiedPickupDirectory or PickupDirectoryFromIis.

- oder --or- EnableSsl wird auf true, festgelegt, aber der SMTP-E-Mail-Server hat nicht STARTTLS in der Antwort auf den EHLO-Befehl angeboten.EnableSsl is set to true, but the SMTP mail server did not advertise STARTTLS in the response to the EHLO command.

Die message konnte an einen der Empfänger in To, CC oder Bcc nicht übermittelt werden.The message could not be delivered to one of the recipients in To, CC, or Bcc.

Die message konnte an mindestens zwei Empfänger in To, CC oder Bcc nicht übermittelt werden.The message could not be delivered to two or more of the recipients in To, CC, or Bcc.

Hinweise

Diese Methode blockiert, während der Übertragung der e-Mails.This method blocks while the email is transmitted. Sie können angeben, ein Timeout-Wert mithilfe der Timeout Eigenschaft, um sicherzustellen, dass die Methode, nach einem angegebenen Zeitraum abgelaufen ist zurückgibt.You can specify a time-out value using the Timeout property to ensure that the method returns after a specified amount of time elapses.

Vor dem Aufrufen dieser Methode die Host und Port Eigenschaften müssen festgelegt werden entweder über die Konfigurationsdateien durch Festlegen der relevanten Eigenschaften oder durch Übergeben dieser Informationen in den SmtpClient(String, Int32) Konstruktor.Before calling this method, the Host and Port properties must be set either through the configuration files by setting the relevant properties, or by passing this information into the SmtpClient(String, Int32) constructor.

Sie können nicht diese Methode aufrufen, wenn eine Nachricht asynchron gesendet werden.You cannot call this method if there is a message being sent asynchronously.

Wenn der SMTP-Host Anmeldeinformationen erfordert, müssen Sie diese vor dem Aufrufen dieser Methode festlegen.If the SMTP host requires credentials, you must set them before calling this method. Verwenden Sie zum Angeben der Anmeldeinformationen der UseDefaultCredentials oder Credentials Eigenschaften.To specify credentials, use the UseDefaultCredentials or Credentials properties.

Wenn Sie erhalten ein SmtpException Ausnahme Überprüfen der StatusCode Eigenschaft, um festzustellen, was den Vorgang ist fehlgeschlagen.If you receive an SmtpException exception, check the StatusCode property to find the reason the operation failed. Die SmtpException kann auch eine innere Ausnahme, die gibt den Grund Fehler bei Vorgang enthalten.The SmtpException can also contain an inner exception that indicates the reason the operation failed.

Beim Senden von e-Mails unter Verwendung Send an mehrere Empfänger und die SMTP-Server einige Empfänger als gültig akzeptiert, und lehnt Sie ab, die andere Send sendet eine e-Mail an die Empfänger akzeptiert und dann eine SmtpFailedRecipientsException wird ausgelöst, (oder ein SmtpFailedRecipientException nur eine Empfänger abgelehnt).When sending email using Send to multiple recipients and the SMTP server accepts some recipients as valid and rejects others, Send sends email to the accepted recipients and then a SmtpFailedRecipientsException is thrown (or a SmtpFailedRecipientException if only one recipient is rejected). Ein SmtpFailedRecipientsException enthält eine Liste der Empfänger, die abgelehnt wurden.A SmtpFailedRecipientsException contains a list of the recipients that were rejected.

Hinweis

Wenn die EnableSsl -Eigenschaftensatz auf true, und die SMTP-Mailserver wirbt nicht STARTTLS in der Antwort auf den EHLO Befehl klicken Sie dann einen Aufruf der Send oder SendAsync Methoden lösen eine SmtpException.If the EnableSsl property is set to true, and the SMTP mail server does not advertise STARTTLS in the response to the EHLO command, then a call to the Send or SendAsync methods will throw an SmtpException.

Sicherheit

SmtpPermission
Die Verbindung zum SMTP-Server.to connect to the SMTP server. Zugeordnete Enumeration: ConnectAssociated enumeration: Connect

Gilt für: