MailDefinition.CreateMailMessage Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Tworzy wiadomość e-mail do wysłania za pomocą protokołu SMTP (Simple Mail Transfer Protocol).
Przeciążenia
| Nazwa | Opis |
|---|---|
| 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.MailMessagePublic Function CreateMailMessage (recipients As String, replacements As IDictionary, owner As Control) As MailMessageParametry
- 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
ElementControl, który jest właścicielem tego .MailDefinition
Zwraca
Wiadomość e-mail z pliku tekstowego.
Wyjątki
replacements nie zawiera ciągów.
From Wartość w sekcji SMTP pliku konfiguracji to null lub pusty ciąg
— lub —
recipients zawiera niepoprawny adres e-mail.
Parametr owner ma wartość 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 dla klasy 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)
Poniższy przykład kodu używa 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 dla klasy 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)
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 tak, aby wskazywała, czy wiadomość e-mail powinna być sformatowana jako zwykły tekst (MailFormat.Text) czy 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 katalog do wyszukania pliku tekstowego określonego BodyFileName we 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.MailMessagePublic Function CreateMailMessage (recipients As String, replacements As IDictionary, body As String, owner As Control) As MailMessageParametry
- 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
ElementControl, który jest właścicielem tego .MailDefinition
Zwraca
Wiadomość e-mail z zamianami z pliku tekstowego.
Wyjątki
replacements nie zawiera ciągów.
From Wartość w sekcji SMTP pliku konfiguracji to null lub pusty ciąg ("").
— lub —
recipients zawiera niepoprawny adres e-mail.
Parametr owner ma wartość 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 dla klasy 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)
Poniższy przykład kodu używa CreateMailMessage metody do utworzenia nowej wiadomości e-mail z tekstu wprowadzonego w kontrolce TextBox na stronie formularzy sieci Web.
Ten przykład kodu jest częścią większego przykładu udostępnionego dla klasy 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)
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 katalog do wyszukania pliku tekstowego określonego BodyFileName we właściwości .
