MailDefinition.CreateMailMessage 메서드

정의

네임스페이스:

System.Web.UI.WebControls

어셈블리:

System.Web.dll

SMTP(Simple Mail Transfer Protocol)를 통해 보낼 이메일 메시지를 만듭니다.

오버로드

CreateMailMessage(String, IDictionary, Control)	SMTP(Simple Mail Transfer Protocol)를 통해 보낼 이메일 메시지를 텍스트 파일로부터 만듭니다.
CreateMailMessage(String, IDictionary, String, Control)	SMTP(Simple Mail Transfer Protocol)를 통해 보낼 이메일 메시지와 대체 항목을 텍스트 파일로부터 만듭니다.

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인 경우

예제

다음 코드 예제에서는 전자 메일 메시지에서 대체되는 두 문자열("<%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 일반 텍스트 형식으로 메일 메시지의 형식을 지정 해야 하는지 여부를 나타내는 속성을 설정 해야 합니다 (MailFormat.Text) 또는 HTML (MailFormat.Html).

recipients 매개 변수를 쉼표로 구분 된 전자 메일 메시지의 받는 사람 목록을 포함 합니다. 경우는 recipients 매개 변수 형식이 적절 하지 않은 인터넷 전자 메일 주소를 포함 합니다 Send 메서드가 throw는 HttpException 예외 및 전자 메일 메시지가 전송 되지 않습니다.

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

합니다 owner 매개 변수는 컨트롤의 부모인 나타냅니다는 MailDefinition 제어 합니다. 에 지정 된 텍스트 파일에 대 한 검색할 디렉터리를 확인 하는 것은 BodyFileName 속성입니다.

추가 정보

• SmtpClient
• MailMessage
• EmbeddedMailObject

CreateMailMessage(String, IDictionary, String, Control)

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

매개 변수

recipients

String

쉼표로 구분된 받는 사람 목록입니다.

replacements

IDictionary

문자열과 대체 문자열 목록이 포함된 IDictionary입니다.

body

String

이메일 메시지의 텍스트입니다.

owner

Control

이 Control 컬렉션을 소유하는 MailDefinition입니다.

반환

MailMessage

텍스트 파일의 이메일 메시지와 대체 항목입니다.

예외

ArgumentException

replacements에 문자열이 포함되지 않은 경우

HttpException

구성 파일에 있는 SMTP 섹션의 From 값이 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 에 입력 된 텍스트에서 새 전자 메일 메시지를 작성 하는 방법을 TextBox Web Forms 페이지에 컨트롤입니다.

이 코드 예제는에 대해 제공 된 큰 예제의 일부는 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 메서드가 throw는 HttpException 예외 및 전자 메일 메시지가 전송 되지 않습니다.

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

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

합니다 owner 매개 변수는 컨트롤의 부모인 나타냅니다는 MailDefinition 제어 합니다. 에 지정 된 텍스트 파일에 대 한 검색할 디렉터리를 확인 하는 것은 BodyFileName 속성입니다.

추가 정보

• SmtpClient
• MailMessage
• EmbeddedMailObject