MailDefinition.CreateMailMessage Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.MailMessagePublic Function CreateMailMessage (recipients As String, replacements As IDictionary, owner As Control) As MailMessageParameter
- 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
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.MailMessagePublic Function CreateMailMessage (recipients As String, replacements As IDictionary, body As String, owner As Control) As MailMessageParameter
- 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
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.