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-Nachricht, die mithilfe von SMTP (Simple Mail Transfer Protocol) gesendet werden soll.
Überlädt
| Name | Beschreibung |
|---|---|
| CreateMailMessage(String, IDictionary, Control) |
Erstellt eine E-Mail-Nachricht aus einer Textdatei, die mithilfe von SMTP (Simple Mail Transfer Protocol) gesendet werden soll. |
| CreateMailMessage(String, IDictionary, String, Control) |
Erstellt eine E-Mail-Nachricht mit Ersetzungen aus einer Textdatei, die über SMTP (Simple Mail Transfer Protocol) gesendet werden soll. |
CreateMailMessage(String, IDictionary, Control)
Erstellt eine E-Mail-Nachricht aus einer Textdatei, die mithilfe von 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 Nachrichtenempfängern.
- replacements
- IDictionary
Eine IDictionary Liste mit Zeichenfolgen und deren Ersetzungszeichenfolgen.
- owner
- Control
Das Control ist der Besitzer MailDefinition.
Gibt zurück
Die E-Mail-Nachricht aus einer Textdatei.
Ausnahmen
replacements enthält keine Zeichenfolgen.
Der From Wert im SMTP-Abschnitt der Konfigurationsdatei ist null oder die 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 (MailFormat.Text) oder HTML (MailFormat.Html) formatiert werden soll.
Der recipients Parameter enthält eine durch Trennzeichen getrennte 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 Send Methode eine HttpException Ausnahme aus, und die 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, welches Steuerelement das übergeordnete Element des MailDefinition Steuerelements ist. Es bestimmt, welches Verzeichnis nach der in der BodyFileName Eigenschaft angegebenen Textdatei gesucht werden soll.
Weitere Informationen
Gilt für:
CreateMailMessage(String, IDictionary, String, Control)
Erstellt eine E-Mail-Nachricht mit Ersetzungen 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::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
Eine IDictionary Liste mit Zeichenfolgen und deren Ersetzungszeichenfolgen.
- body
- String
Der Text der E-Mail-Nachricht.
- owner
- Control
Das Control ist der Besitzer MailDefinition.
Gibt zurück
Die E-Mail-Nachricht 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 CreateMailMessage Methode verwendet, um eine neue E-Mail-Nachricht aus Text zu erstellen, der in ein 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 durch Trennzeichen getrennte 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 Send Methode eine HttpException Ausnahme aus, und die 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, welches Steuerelement das übergeordnete Element des MailDefinition Steuerelements ist. Es bestimmt, welches Verzeichnis nach der in der BodyFileName Eigenschaft angegebenen Textdatei gesucht werden soll.
