MailDefinition.CreateMailMessage Yöntem

Tanım

Ad Alanı:

System.Web.UI.WebControls

Bütünleştirilmiş Kod:

System.Web.dll

SMTP (Basit Posta Aktarım Protokolü) yoluyla gönderilecek bir e-posta iletisi oluşturur.

Aşırı Yüklemeler

CreateMailMessage(String, IDictionary, Control)	SMTP (Basit Posta Aktarım Protokolü) aracılığıyla gönderilecek bir metin dosyasından e-posta iletisi oluşturur.
CreateMailMessage(String, IDictionary, String, Control)	SMTP (Basit Posta Aktarım Protokolü) aracılığıyla gönderilecek metin dosyasından değiştirmeleri olan bir e-posta iletisi oluşturur.

CreateMailMessage(String, IDictionary, Control)

SMTP (Basit Posta Aktarım Protokolü) aracılığıyla gönderilecek bir metin dosyasından e-posta iletisi oluşturur.

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

Parametreler

recipients

String

İleti alıcılarının virgülle ayrılmış listesi.

replacements

IDictionary

Dizelerin IDictionary ve bunların değiştirme dizelerinin listesini içeren.

owner

Control

Bu Control MailDefinitionöğesinin sahibi.

Döndürülenler

MailMessage

Bir metin dosyasından gelen e-posta iletisi.

Özel durumlar

ArgumentException

replacements dize içermez.

HttpException

From Yapılandırma dosyasının SMTP bölümündeki değer veya boş dizedir null

-veya-

recipients yanlış bir e-posta adresi içeriyor.

ArgumentNullException

owner, null değeridir.

Örnekler

Aşağıdaki kod örneği, e-posta iletisinde değiştirilen iki dizeyi ("<%To%>" ve "<%From%>") tanımlayan bir ListDictionary nesne oluşturur.

Bu kod örneği, sınıfı için MailDefinition sağlanan daha büyük bir örneğin parçasıdır.

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)

Aşağıdaki kod örneği, bir metin dosyasından CreateMailMessage yeni bir e-posta iletisi oluşturmak için yöntemini kullanır.

Bu kod örneği, sınıfı için MailDefinition sağlanan daha büyük bir örneğin parçasıdır.

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)

Açıklamalar

CreateMailMessage yöntemi, yöntemi kullanılarak SmtpClient.Send gönderilebilen yeni MailMessage bir nesne oluşturur.

özelliği, BodyFormat posta iletisinin düz metin () veya HTMLMailFormat.Html (MailFormat.Text) olarak biçimlendirilip biçimlendirilmeyeceğini gösterecek şekilde ayarlanmalıdır.

parametresi, recipients e-posta iletisinin alıcılarının virgülle ayrılmış bir listesini içerir. recipients Parametresi yanlış biçimlendirilmiş bir İnternet e-posta adresi içeriyorsa, Send yöntem bir HttpException özel durum oluşturur ve e-posta iletisi gönderilmez.

replacements parametresi, yerine geçecek dizelerin listesini içeren bir IDictionary örnektir. Dizeler koleksiyona IDictionary eklendikleri sırayla değiştirilir ve önceki değiştirmelerin üzerine yazılabilir.

parametresi, owner hangi denetimin denetimin üst öğesi MailDefinition olduğunu gösterir. özelliğinde BodyFileName belirtilen metin dosyasının arandığı dizini belirler.

Ayrıca bkz.

• SmtpClient
• MailMessage
• EmbeddedMailObject

CreateMailMessage(String, IDictionary, String, Control)

SMTP (Basit Posta Aktarım Protokolü) aracılığıyla gönderilecek metin dosyasından değiştirmeleri olan bir e-posta iletisi oluşturur.

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

Parametreler

recipients

String

Alıcıların virgülle ayrılmış listesi.

replacements

IDictionary

Dizelerin IDictionary ve bunların değiştirme dizelerinin listesini içeren.

body

String

E-posta iletisinin metni.

owner

Control

Bu Control MailDefinitionöğesinin sahibi.

Döndürülenler

MailMessage

Metin dosyasındaki değişiklikleri içeren e-posta iletisi.

Özel durumlar

ArgumentException

replacements dize içermez.

HttpException

From Yapılandırma dosyasının null SMTP bölümündeki değer veya boş bir dize ("").

-veya-

recipients yanlış bir e-posta adresi içeriyor.

ArgumentNullException

owner, null değeridir.

Örnekler

Aşağıdaki kod örneği, e-posta iletisinde değiştirilen iki dizeyi ("<%To%>" ve "<%From%>") tanımlayan bir ListDictionary nesne oluşturur.

Bu kod örneği, sınıfı için MailDefinition sağlanan daha büyük bir örneğin parçasıdır.

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)

Aşağıdaki kod örneği, CreateMailMessage Web Forms sayfasındaki bir denetime girilen metinden yeni bir TextBox e-posta iletisi oluşturmak için yöntemini kullanır.

Bu kod örneği, sınıfı için MailDefinition sağlanan daha büyük bir örneğin parçasıdır.

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)

Açıklamalar

CreateMailMessage yöntemi ile SmtpClient.Send gönderilebilen yeni MailMessage bir nesne oluşturur.

parametresi, recipients e-posta iletisinin alıcılarının virgülle ayrılmış bir listesini içerir. recipients Parametresi yanlış biçimlendirilmiş bir İnternet e-posta adresi içeriyorsa, Send yöntem bir HttpException özel durum oluşturur ve e-posta iletisi gönderilmez.

replacements parametresi, yerine geçecek dizelerin listesini içeren bir IDictionary örnektir. Dizeler koleksiyona IDictionary eklendikleri sırayla değiştirilir ve önceki değiştirmelerin üzerine yazılabilir.

body parametresi, e-posta iletisinin metnini içerir.

parametresi, owner hangi denetimin denetimin üst öğesi MailDefinition olduğunu gösterir. özelliğinde BodyFileName belirtilen metin dosyasının arandığı dizini belirler.

Ayrıca bkz.

• SmtpClient
• MailMessage
• EmbeddedMailObject