MailDefinition.CreateMailMessage Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Vytvoří e-mailovou zprávu pro odeslání prostřednictvím protokolu SMTP (Simple Mail Transfer Protocol).
Přetížení
| CreateMailMessage(String, IDictionary, Control) |
Vytvoří e-mailovou zprávu z textového souboru pro odeslání prostřednictvím protokolu SMTP (Simple Mail Transfer Protocol). |
| CreateMailMessage(String, IDictionary, String, Control) |
Vytvoří e-mailovou zprávu s nahrazením z textového souboru, který se má odeslat pomocí protokolu SMTP (Simple Mail Transfer Protocol). |
CreateMailMessage(String, IDictionary, Control)
Vytvoří e-mailovou zprávu z textového souboru pro odeslání prostřednictvím protokolu SMTP (Simple Mail Transfer Protocol).
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 MailMessageParametry
- recipients
- String
Seznam příjemců zpráv oddělený čárkami
- replacements
- IDictionary
Obsahuje IDictionary seznam řetězců a jejich náhradních řetězců.
- owner
- Control
To Control vlastní MailDefinition.
Návraty
E-mailová zpráva z textového souboru.
Výjimky
replacements neobsahuje řetězce.
Hodnota From v části SMTP konfiguračního souboru je null nebo prázdný řetězec.
-nebo-
recipients obsahuje nesprávnou e-mailovou adresu.
owner je null.
Příklady
Následující příklad kódu vytvoří ListDictionary objekt, který definuje dva řetězce ("<%To%>" a "<%From%>"), které jsou nahrazeny v e-mailové zprávě.
Tento příklad kódu je součástí většího příkladu zadaného MailDefinition pro třídu.
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)
Následující příklad kódu používá metodu CreateMailMessage k vytvoření nové e-mailové zprávy z textového souboru.
Tento příklad kódu je součástí většího příkladu zadaného MailDefinition pro třídu.
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)
Poznámky
Metoda CreateMailMessage vytvoří nový MailMessage objekt, který lze odeslat pomocí SmtpClient.Send metody.
Vlastnost BodyFormat musí být nastavena tak, aby označovala, jestli má být poštovní zpráva formátovaná jako prostý text (MailFormat.Text) nebo HTML (MailFormat.Html).
Parametr recipients obsahuje seznam příjemců e-mailové zprávy oddělený čárkami. recipients Pokud parametr obsahuje nesprávně formátovanou internetovou e-mailovou adresu, Send metoda vyvolá HttpException výjimku a e-mailová zpráva se neodesílají.
Parametr replacements je IDictionary instance, která obsahuje seznam řetězců, které se mají nahradit. Řetězce se nahradí v pořadí, ve kterém byly přidány do IDictionary kolekce, a mohou přepsat dřívější nahrazení.
Parametr owner označuje, který ovládací prvek je nadřazený ovládacím MailDefinition prvku. Určuje, který adresář se má vyhledat v textovém souboru zadaném BodyFileName ve vlastnosti.
Viz také
Platí pro
CreateMailMessage(String, IDictionary, String, Control)
Vytvoří e-mailovou zprávu s nahrazením z textového souboru, který se má odeslat pomocí protokolu SMTP (Simple Mail Transfer Protocol).
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 MailMessageParametry
- recipients
- String
Seznam příjemců oddělený čárkami.
- replacements
- IDictionary
Obsahuje IDictionary seznam řetězců a jejich náhradních řetězců.
- body
- String
Text e-mailové zprávy
- owner
- Control
To Control vlastní MailDefinition.
Návraty
E-mailová zpráva s nahrazením z textového souboru.
Výjimky
replacements neobsahuje řetězce.
Hodnota From v části SMTP konfiguračního souboru je null nebo prázdný řetězec ("").
-nebo-
recipients obsahuje nesprávnou e-mailovou adresu.
owner je null.
Příklady
Následující příklad kódu vytvoří ListDictionary objekt, který definuje dva řetězce ("<%To%>" a "<%From%>"), které jsou nahrazeny v e-mailové zprávě.
Tento příklad kódu je součástí většího příkladu zadaného MailDefinition pro třídu.
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)
Následující příklad kódu používá metodu CreateMailMessage k vytvoření nové e-mailové zprávy z textu zadaného v ovládacím TextBox prvku na Web Forms stránce.
Tento příklad kódu je součástí většího příkladu zadaného MailDefinition pro třídu.
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)
Poznámky
Metoda CreateMailMessage vytvoří nový MailMessage objekt, který lze odeslat pomocí SmtpClient.Send metody.
Parametr recipients obsahuje seznam příjemců e-mailové zprávy oddělený čárkami. recipients Pokud parametr obsahuje nesprávně formátovanou internetovou e-mailovou adresu, Send metoda vyvolá HttpException výjimku a e-mailová zpráva se neodesílají.
Parametr replacements je IDictionary instance, která obsahuje seznam řetězců, které se mají nahradit. Řetězce se nahradí v pořadí, ve kterém byly přidány do IDictionary kolekce, a mohou přepsat dřívější nahrazení.
Parametr body obsahuje text e-mailové zprávy.
Parametr owner označuje, který ovládací prvek je nadřazený ovládacím MailDefinition prvku. Určuje, který adresář se má vyhledat v textovém souboru zadaném BodyFileName ve vlastnosti.