Share via

MailDefinition.CreateMailMessage Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls
Zestaw:
System.Web.dll

Tworzy wiadomość e-mail do wysłania za pomocą protokołu SMTP (Simple Mail Transfer Protocol).

Przeciążenia

CreateMailMessage(String, IDictionary, Control)

Tworzy wiadomość e-mail z pliku tekstowego do wysłania za pomocą protokołu SMTP (Simple Mail Transfer Protocol).
CreateMailMessage(String, IDictionary, String, Control)

Tworzy wiadomość e-mail z zamianami z pliku tekstowego do wysłania za pomocą protokołu SMTP (Simple Mail Transfer Protocol).

CreateMailMessage(String, IDictionary, Control)

Tworzy wiadomość e-mail z pliku tekstowego do wysłania za pomocą protokołu 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.MailMessage
Public Function CreateMailMessage (recipients As String, replacements As IDictionary, owner As Control) As MailMessage

Parametry

recipients
String

Rozdzielona przecinkami lista adresatów wiadomości.

replacements
IDictionary

Element IDictionary zawierający listę ciągów i ich ciągów zastępczych.

owner
Control

Element Control , który jest właścicielem tego MailDefinition.

Zwraca

MailMessage

Wiadomość e-mail z pliku tekstowego.

Wyjątki

ArgumentException

replacements nie zawiera ciągów.

HttpException

From Wartość w sekcji SMTP pliku konfiguracji to null lub pusty ciąg

-lub-

recipients zawiera niepoprawny adres e-mail.

ArgumentNullException

owner to null.

Przykłady

Poniższy przykład kodu tworzy ListDictionary obiekt, który definiuje dwa ciągi ("<%To%>" i "<%From%>"), które są zastępowane w wiadomości e-mail.

Ten przykład kodu jest częścią większego przykładu udostępnionego MailDefinition dla klasy .

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)

W poniższym przykładzie kodu użyto CreateMailMessage metody do utworzenia nowej wiadomości e-mail z pliku tekstowego.

Ten przykład kodu jest częścią większego przykładu udostępnionego MailDefinition dla klasy .

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)

Uwagi

Metoda CreateMailMessage tworzy nowy MailMessage obiekt, który można wysłać przy użyciu SmtpClient.Send metody .

Właściwość musi być ustawiona BodyFormat , aby wskazać, czy wiadomość e-mail powinna być sformatowana jako zwykły tekst (MailFormat.Text) lub HTML (MailFormat.Html).

Parametr recipients zawiera rozdzielaną przecinkami listę adresatów wiadomości e-mail. recipients Jeśli parametr zawiera niepoprawnie sformatowany internetowy adres e-mail, Send metoda zgłasza HttpException wyjątek i wiadomość e-mail nie jest wysyłana.

Parametr replacements jest wystąpieniem IDictionary , które zawiera listę ciągów do zastąpienia. Ciągi są zastępowane w kolejności, w której zostały dodane do IDictionary kolekcji, i mogą zastąpić wcześniejsze zamiany.

Parametr owner wskazuje, która kontrolka jest elementem nadrzędnym kontrolki MailDefinition . Określa, który katalog ma wyszukiwać plik tekstowy określony we BodyFileName właściwości .

Zobacz też

Dotyczy

CreateMailMessage(String, IDictionary, String, Control)

Tworzy wiadomość e-mail z zamianami z pliku tekstowego do wysłania za pomocą protokołu 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.MailMessage
Public Function CreateMailMessage (recipients As String, replacements As IDictionary, body As String, owner As Control) As MailMessage

Parametry

recipients
String

Rozdzielona przecinkami lista adresatów.

replacements
IDictionary

Element IDictionary zawierający listę ciągów i ich ciągów zastępczych.

body
String

Tekst wiadomości e-mail.

owner
Control

Element Control , który jest właścicielem tego MailDefinition.

Zwraca

MailMessage

Wiadomość e-mail z zamianami z pliku tekstowego.

Wyjątki

ArgumentException

replacements nie zawiera ciągów.

HttpException

From Wartość w sekcji SMTP pliku konfiguracji to null lub pusty ciąg ("").

-lub-

recipients zawiera niepoprawny adres e-mail.

ArgumentNullException

owner to null.

Przykłady

Poniższy przykład kodu tworzy ListDictionary obiekt, który definiuje dwa ciągi ("<%To%>" i "<%From%>"), które są zastępowane w wiadomości e-mail.

Ten przykład kodu jest częścią większego przykładu udostępnionego MailDefinition dla klasy .

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)

Poniższy przykład kodu używa CreateMailMessage metody do utworzenia nowej wiadomości e-mail z tekstu wprowadzonego w kontrolce TextBox na stronie Web Forms.

Ten przykład kodu jest częścią większego przykładu udostępnionego MailDefinition dla klasy .

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)

Uwagi

Metoda CreateMailMessage tworzy nowy MailMessage obiekt, który można wysłać za SmtpClient.Send pomocą metody .

Parametr recipients zawiera rozdzielaną przecinkami listę adresatów wiadomości e-mail. recipients Jeśli parametr zawiera niepoprawnie sformatowany internetowy adres e-mail, Send metoda zgłasza HttpException wyjątek i wiadomość e-mail nie jest wysyłana.

Parametr replacements jest wystąpieniem IDictionary , które zawiera listę ciągów do zastąpienia. Ciągi są zastępowane w kolejności, w której zostały dodane do IDictionary kolekcji, i mogą zastąpić wcześniejsze zamiany.

Parametr body zawiera tekst wiadomości e-mail.

Parametr owner wskazuje, która kontrolka jest elementem nadrzędnym kontrolki MailDefinition . Określa, który katalog ma wyszukiwać plik tekstowy określony we BodyFileName właściwości .

Zobacz też

Dotyczy