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 k odeslání pomocí protokolu SMTP (Simple Mail Transfer Protocol).
Přetížení
| Name | Description |
|---|---|
| CreateMailMessage(String, IDictionary, Control) |
Vytvoří e-mailovou zprávu z textového souboru, který se má odeslat protokolem 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, který se má odeslat protokolem 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 , co to MailDefinitionvlastní .
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 uvedeného pro třídu MailDefinition.
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 uvedeného pro třídu MailDefinition.
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 musí být nastavena BodyFormat tak, aby označovala, zda má být poštovní zpráva formátována jako prostý text (MailFormat.Text) nebo HTML (MailFormat.Html).
Parametr recipients obsahuje čárkami oddělený seznam příjemců e-mailové zprávy.
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í, v jakém byly přidány do IDictionary kolekce, a mohou přepsat dřívější nahrazení.
Parametr owner urč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ých čá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 , co to MailDefinitionvlastní .
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 uvedeného pro třídu MailDefinition.
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 stránce Webové formuláře.
Tento příklad kódu je součástí většího příkladu uvedeného pro třídu MailDefinition.
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 s metodou SmtpClient.Send .
Parametr recipients obsahuje čárkami oddělený seznam příjemců e-mailové zprávy.
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í, v jaké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 urč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.
