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

Name	Description
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 bir 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 yerine geçen dizelerin listesini içeren.

owner

Control

Bunun Control sahibi MailDefinition.

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'e eşittir.

Ö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

yöntemi, CreateMailMessage 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.

owner parametresi, 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 bir 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

Virgülle ayrılmış alıcı listesi.

replacements

IDictionary

Dizelerin IDictionary ve bunların yerine geçen dizelerin listesini içeren.

body

String

E-posta iletisinin metni.

owner

Control

Bunun Control sahibi MailDefinition.

Döndürülenler

MailMessage

Bir metin dosyasından değiştirilen 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 dizedir ("").

-veya-

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

ArgumentNullException

owner, null'e eşittir.

Ö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, Web Forms sayfasındaki denetime girilen metinden yeni bir TextBox e-posta iletisi oluşturmak için yöntemini kullanırCreateMailMessage.

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

yöntemi, CreateMailMessage yöntemiyle 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.

owner parametresi, 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