Freigeben über


MailDefinition.CreateMailMessage Methode

Definition

Erstellt eine E-Mail, die über SMTP gesendet werden soll.

Überlädt

CreateMailMessage(String, IDictionary, Control)

Erstellt eine E-Mail aus einer Textdatei, die über SMTP (Simple Mail Transfer Protocol) gesendet werden soll.

CreateMailMessage(String, IDictionary, String, Control)

Erstellt eine E-Mail mit Ersetzungen aus einer Textdatei, die über SMTP gesendet werden soll.

CreateMailMessage(String, IDictionary, Control)

Erstellt eine E-Mail aus einer Textdatei, die über SMTP (Simple Mail Transfer Protocol) gesendet werden soll.

public:
 System::Net::Mail::MailMessage ^ CreateMailMessage(System::String ^ recipients, System::Collections::IDictionary ^ replacements, System::Web::UI::Control ^ owner);
public System.Net.Mail.MailMessage CreateMailMessage (string recipients, System.Collections.IDictionary replacements, System.Web.UI.Control owner);
member this.CreateMailMessage : string * System.Collections.IDictionary * System.Web.UI.Control -> System.Net.Mail.MailMessage
Public Function CreateMailMessage (recipients As String, replacements As IDictionary, owner As Control) As MailMessage

Parameter

recipients
String

Eine durch Trennzeichen getrennte Liste von Empfängern der Nachricht.

replacements
IDictionary

Ein IDictionary, das eine Liste mit Zeichenfolgen und deren Ersetzungszeichenfolgen enthält.

owner
Control

Das Control, das diese MailDefinition besitzt.

Gibt zurück

MailMessage

Die E-Mail aus einer Textdatei.

Ausnahmen

replacements enthält keine Zeichenfolgen.

Der From-Wert im SMTP-Abschnitt der Konfigurationsdatei ist null oder eine leere Zeichenfolge ("").

- oder -

recipients enthält eine falsche E-Mail-Adresse.

owner ist null.

Beispiele

Im folgenden Codebeispiel wird ein ListDictionary Objekt erstellt, das zwei Zeichenfolgen ("<%To%>" und "<%From%>") definiert, die in der E-Mail-Nachricht ersetzt werden.

Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die MailDefinition Klasse bereitgestellt wird.

ListDictionary replacements = new ListDictionary();
replacements.Add("<%To%>",sourceTo.Text);
replacements.Add("<%From%>", md.From);
Dim replacements As ListDictionary = New ListDictionary
replacements.Add("<%To%>", sourceTo.Text)
replacements.Add("<%From%>", sourceFrom.Text)

Im folgenden Codebeispiel wird die CreateMailMessage Methode verwendet, um eine neue E-Mail-Nachricht aus einer Textdatei zu erstellen.

Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die MailDefinition Klasse bereitgestellt wird.

System.Net.Mail.MailMessage fileMsg;
fileMsg = md.CreateMailMessage(sourceTo.Text, replacements, this); 
Dim fileMsg As System.Net.Mail.MailMessage
fileMsg = md.CreateMailMessage(sourceTo.Text, replacements, Me)

Hinweise

Die CreateMailMessage Methode erstellt ein neues MailMessage Objekt, das mithilfe der SmtpClient.Send Methode gesendet werden kann.

Die BodyFormat Eigenschaft muss festgelegt werden, um anzugeben, ob die E-Mail-Nachricht als nur Text () oder HTML formatiert werden soll (MailFormat.TextMailFormat.Html).

Der recipients Parameter enthält eine kommatrennte Liste der Empfänger der E-Mail-Nachricht. Wenn der recipients Parameter eine nicht ordnungsgemäß formatierte Internet-E-Mail-Adresse enthält, löst die Methode eine HttpException Ausnahme aus, und die Send E-Mail-Nachricht wird nicht gesendet.

Der replacements Parameter ist eine IDictionary Instanz, die eine Liste der zu ersetzenden Zeichenfolgen enthält. Zeichenfolgen werden in der Reihenfolge ersetzt, in der sie der IDictionary Auflistung hinzugefügt wurden, und sie können frühere Ersetzungen überschreiben.

Der owner Parameter gibt an, welche Steuerelemente das übergeordnete Steuerelement des MailDefinition Steuerelements sind. Es bestimmt, welches Verzeichnis nach der in der BodyFileName Eigenschaft angegebenen Textdatei gesucht werden soll.

Siehe auch

Gilt für

CreateMailMessage(String, IDictionary, String, Control)

Erstellt eine E-Mail mit Ersetzungen aus einer Textdatei, die über SMTP gesendet werden soll.

public:
 System::Net::Mail::MailMessage ^ CreateMailMessage(System::String ^ recipients, System::Collections::IDictionary ^ replacements, System::String ^ body, System::Web::UI::Control ^ owner);
public System.Net.Mail.MailMessage CreateMailMessage (string recipients, System.Collections.IDictionary replacements, string body, System.Web.UI.Control owner);
member this.CreateMailMessage : string * System.Collections.IDictionary * string * System.Web.UI.Control -> System.Net.Mail.MailMessage
Public Function CreateMailMessage (recipients As String, replacements As IDictionary, body As String, owner As Control) As MailMessage

Parameter

recipients
String

Die durch Trennzeichen getrennte Liste der Empfänger.

replacements
IDictionary

Ein IDictionary, das eine Liste mit Zeichenfolgen und deren Ersetzungszeichenfolgen enthält.

body
String

Der Text der E-Mail.

owner
Control

Das Control, das diese MailDefinition besitzt.

Gibt zurück

MailMessage

Die E-Mail mit Ersetzungen aus einer Textdatei.

Ausnahmen

replacements enthält keine Zeichenfolgen.

Der From-Wert im SMTP-Abschnitt der Konfigurationsdatei ist null oder eine leere Zeichenfolge ("").

- oder -

recipients enthält eine falsche E-Mail-Adresse.

owner ist null.

Beispiele

Im folgenden Codebeispiel wird ein ListDictionary Objekt erstellt, das zwei Zeichenfolgen ("<%To%>" und "<%From%>") definiert, die in der E-Mail-Nachricht ersetzt werden.

Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die MailDefinition Klasse bereitgestellt wird.

ListDictionary replacements = new ListDictionary();
replacements.Add("<%To%>",sourceTo.Text);
replacements.Add("<%From%>", md.From);
Dim replacements As ListDictionary = New ListDictionary
replacements.Add("<%To%>", sourceTo.Text)
replacements.Add("<%From%>", sourceFrom.Text)

Im folgenden Codebeispiel wird die Methode verwendet, um eine neue E-Mail-Nachricht aus Text zu erstellen, die CreateMailMessage in einem TextBox Steuerelement auf einer Web Forms Seite eingegeben wurde.

Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die MailDefinition Klasse bereitgestellt wird.

System.Net.Mail.MailMessage fileMsg;
fileMsg = md.CreateMailMessage(sourceTo.Text, replacements, this); 
Dim fileMsg As System.Net.Mail.MailMessage
fileMsg = md.CreateMailMessage(sourceTo.Text, replacements, Me)

Hinweise

Die CreateMailMessage Methode erstellt ein neues MailMessage Objekt, das mit der SmtpClient.Send Methode gesendet werden kann.

Der recipients Parameter enthält eine kommatrennte Liste der Empfänger der E-Mail-Nachricht. Wenn der recipients Parameter eine nicht ordnungsgemäß formatierte Internet-E-Mail-Adresse enthält, löst die Methode eine HttpException Ausnahme aus, und die Send E-Mail-Nachricht wird nicht gesendet.

Der replacements Parameter ist eine IDictionary Instanz, die eine Liste der zu ersetzenden Zeichenfolgen enthält. Zeichenfolgen werden in der Reihenfolge ersetzt, in der sie der IDictionary Auflistung hinzugefügt wurden, und sie können frühere Ersetzungen überschreiben.

Der body Parameter enthält den Text der E-Mail-Nachricht.

Der owner Parameter gibt an, welche Steuerelemente das übergeordnete Steuerelement des MailDefinition Steuerelements sind. Es bestimmt, welches Verzeichnis nach der in der BodyFileName Eigenschaft angegebenen Textdatei gesucht werden soll.

Siehe auch

Gilt für