MailDefinition.CreateMailMessage メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
SMTP (簡易メール転送プロトコル) によって送信される電子メール メッセージを作成します。
オーバーロード
| CreateMailMessage(String, IDictionary, Control) |
テキスト ファイルから、SMTP (Simple Mail Transfer Protocol) によって送信される電子メール メッセージを作成します。 |
| CreateMailMessage(String, IDictionary, String, Control) |
テキスト ファイルの置換文字列を使用して、SMTP (簡易メール転送プロトコル) によって送信される電子メール メッセージを作成します。 |
CreateMailMessage(String, IDictionary, Control)
テキスト ファイルから、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 MailMessageパラメーター
- recipients
- String
コンマ区切りのメッセージ受信者リスト。
- replacements
- IDictionary
文字列およびその置換文字列のリストを格納する IDictionary。
- owner
- Control
この Control を所有している MailDefinition。
戻り値
テキスト ファイルの電子メール メッセージ。
例外
replacements に文字列が含まれていません。
構成ファイルの SMTP セクションの From 値が null または空の文字列です。
- または -
recipients に正しくない電子メール アドレスが含まれています。
owner が nullです。
例
次のコード例では、電子メール メッセージで ListDictionary 置き換えられる 2 つの文字列 ("<%To%>" と "<%From%>") を定義する オブジェクトを作成します。
このコード例は、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)
次のコード例では、 メソッドを CreateMailMessage 使用して、テキスト ファイルから新しい電子メール メッセージを作成します。
このコード例は、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)
注釈
メソッドは CreateMailMessage 、 メソッドを使用して送信できる新しい MailMessage オブジェクトを SmtpClient.Send 作成します。
プロパティはBodyFormat、メール メッセージをプレーン テキスト () または HTML (MailFormat.TextMailFormat.Html) として書式設定する必要があるかどうかを示すように設定する必要があります。
パラメーターには recipients 、電子メール メッセージの受信者のコンマ区切りのリストが含まれています。 パラメーターに recipients 不適切な形式のインターネット 電子メール アドレスが含まれている場合、 Send メソッドは例外を HttpException スローし、電子メール メッセージは送信されません。
パラメーターは replacements 、置換する IDictionary 文字列の一覧を含むインスタンスです。 文字列は、コレクションに追加 IDictionary された順序で置き換えられ、以前の置換を上書きできます。
パラメーターは owner 、コントロールの親であるコントロールを MailDefinition 示します。 プロパティで指定されたテキスト ファイルを検索するディレクトリを BodyFileName 決定します。
こちらもご覧ください
適用対象
CreateMailMessage(String, IDictionary, String, Control)
テキスト ファイルの置換文字列を使用して、SMTP (簡易メール転送プロトコル) によって送信される電子メール メッセージを作成します。
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 MailMessageパラメーター
- recipients
- String
コンマ区切りの受信者リスト。
- replacements
- IDictionary
文字列およびその置換文字列のリストを格納する IDictionary。
- body
- String
電子メールのテキスト。
- owner
- Control
この Control を所有している MailDefinition。
戻り値
テキスト ファイルの置換文字列による電子メール メッセージ。
例外
replacements に文字列が含まれていません。
構成ファイルの SMTP セクションの From 値が null または空の文字列 ("") です。
- または -
recipients に正しくない電子メール アドレスが含まれています。
owner が nullです。
例
次のコード例では、電子メール メッセージで ListDictionary 置き換えられる 2 つの文字列 ("<%To%>" と "<%From%>") を定義する オブジェクトを作成します。
このコード例は、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)
次のコード例では、 メソッドをCreateMailMessage使用して、Web Forms ページのコントロールにTextBox入力されたテキストから新しい電子メール メッセージを作成します。
このコード例は、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)
注釈
メソッドは CreateMailMessage 、 メソッドを使用して送信できる新しい MailMessage オブジェクトを SmtpClient.Send 作成します。
パラメーターには recipients 、電子メール メッセージの受信者のコンマ区切りのリストが含まれています。 パラメーターに recipients 不適切な形式のインターネット 電子メール アドレスが含まれている場合、 Send メソッドは例外を HttpException スローし、電子メール メッセージは送信されません。
パラメーターは replacements 、置換する IDictionary 文字列の一覧を含むインスタンスです。 文字列は、コレクションに追加 IDictionary された順序で置き換えられ、以前の置換を上書きできます。
パラメーターには body 、電子メール メッセージのテキストが含まれています。
パラメーターは owner 、コントロールの親であるコントロールを MailDefinition 示します。 プロパティで指定されたテキスト ファイルを検索するディレクトリを BodyFileName 決定します。
こちらもご覧ください
適用対象
.NET