MailDefinition.CreateMailMessage メソッド

定義

名前空間:

System.Web.UI.WebControls

アセンブリ:

System.Web.dll

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.MailMessage

Public Function CreateMailMessage (recipients As String, replacements As IDictionary, owner As Control) As MailMessage

パラメーター

recipients

String

コンマ区切りのメッセージ受信者リスト。

replacements

IDictionary

文字列およびその置換文字列のリストを格納する IDictionary。

owner

Control

この Control を所有している MailDefinition。

戻り値

MailMessage

テキスト ファイルの電子メール メッセージ。

例外

ArgumentException

replacements に文字列が含まれていません。

HttpException

構成ファイルの SMTP セクションの From 値が null または空の文字列です。

- または -

recipients に正しくない電子メール アドレスが含まれています。

ArgumentNullException

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 決定します。

こちらもご覧ください

• SmtpClient
• MailMessage
• EmbeddedMailObject

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.MailMessage

Public 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。

戻り値

MailMessage

テキスト ファイルの置換文字列による電子メール メッセージ。

例外

ArgumentException

replacements に文字列が含まれていません。

HttpException

構成ファイルの SMTP セクションの From 値が null または空の文字列 ("") です。

- または -

recipients に正しくない電子メール アドレスが含まれています。

ArgumentNullException

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 決定します。

こちらもご覧ください

• SmtpClient
• MailMessage
• EmbeddedMailObject