MailDefinition.CreateMailMessage 메서드

정의

네임스페이스:

System.Web.UI.WebControls

어셈블리:

System.Web.dll

SMTP(단순 메일 전송 프로토콜)를 통해 보낼 전자 메일 메시지를 만듭니다.

오버로드

Name	Description
CreateMailMessage(String, IDictionary, Control)	SMTP(단순 메일 전송 프로토콜)를 통해 보낼 텍스트 파일에서 전자 메일 메시지를 만듭니다.
CreateMailMessage(String, IDictionary, String, Control)	SMTP(단순 메일 전송 프로토콜)를 통해 보낼 텍스트 파일에서 대체된 전자 메일 메시지를 만듭니다.

CreateMailMessage(String, IDictionary, Control)

SMTP(단순 메일 전송 프로토콜)를 통해 보낼 텍스트 파일에서 전자 메일 메시지를 만듭니다.

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

From 구성 파일의 SMTP 섹션에 있는 값 또는 빈 문자열입니다null.

-또는-

recipients 에는 잘못된 전자 메일 주소가 포함되어 있습니다.

ArgumentNullException

owner은 null입니다.

예제

다음 코드 예제에서는 전자 메일 메시지에서 대체되는 두 문자열("<%To%" 및 "<%From%>")을 정의하는 개체를 만듭니다 ListDictionary>.

이 코드 예제는 클래스에 제공된 더 큰 예제의 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 메일 메시지의 서식을 일반 텍스트() 또는 HTMLMailFormat.Html(MailFormat.Text)로 지정해야 하는지 여부를 나타내려면 속성을 설정해야 합니다.

매개 변수에는 recipients 전자 메일 메시지의 받는 사람의 쉼표로 구분된 목록이 포함됩니다. 매개 변수에 recipients 잘못된 형식의 인터넷 전자 메일 주소가 포함되어 있으면 메서드가 Send 예외를 HttpException throw하고 전자 메일 메시지가 전송되지 않습니다.

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

From 구성 파일의 SMTP 섹션에 있는 값은 빈 문자열("")입니다null.

-또는-

recipients 에는 잘못된 전자 메일 주소가 포함되어 있습니다.

ArgumentNullException

owner은 null입니다.

예제

다음 코드 예제에서는 전자 메일 메시지에서 대체되는 두 문자열("<%To%" 및 "<%From%>")을 정의하는 개체를 만듭니다 ListDictionary>.

이 코드 예제는 클래스에 제공된 더 큰 예제의 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 throw하고 전자 메일 메시지가 전송되지 않습니다.

replacements 매개 변수는 IDictionary 대체할 문자열 목록을 포함하는 인스턴스입니다. 문자열은 컬렉션에 추가 IDictionary 된 순서대로 대체되며 이전 대체 항목을 덮어쓸 수 있습니다.

매개 변수에는 body 전자 메일 메시지의 텍스트가 포함됩니다.

매개 변수는 owner 컨트롤의 부모 컨트롤을 MailDefinition 나타냅니다. 속성에 지정된 BodyFileName 텍스트 파일을 검색할 디렉터리를 결정합니다.

추가 정보

• SmtpClient
• MailMessage
• EmbeddedMailObject