Aracılığıyla paylaş

ChangePassword.MailDefinition Özellik

Tanım

Ad Alanı:
System.Web.UI.WebControls
Bütünleştirilmiş Kod:
System.Web.dll

Parolalarını değiştirdikten sonra kullanıcılara gönderilen e-posta iletisini tanımlayan bir özellik koleksiyonuna başvuru alır.

public:
 property System::Web::UI::WebControls::MailDefinition ^ MailDefinition { System::Web::UI::WebControls::MailDefinition ^ get(); };
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
[System.Web.UI.Themeable(false)]
public System.Web.UI.WebControls.MailDefinition MailDefinition { get; }
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
[<System.Web.UI.Themeable(false)>]
member this.MailDefinition : System.Web.UI.WebControls.MailDefinition
Public ReadOnly Property MailDefinition As MailDefinition

Özellik Değeri

MailDefinition

Yeni kullanıcıya MailDefinition gönderilen e-posta iletisini tanımlayan bir nesneye başvuru.

Öznitelikler
PersistenceModeAttribute ThemeableAttribute

Özel durumlar

HttpException

From özelliği bir e-posta adresine ayarlanmadı.

Örnekler

Aşağıdaki kod örneği, özelliğini kullanarak MailDefinition parolalarını değiştiren kullanıcılara gönderilen bir e-posta iletisini tanımlamayı gösterir. Gönderilecek e-posta iletisinin metnini içeren adlı MailFile.txt bir dosya olduğunu varsayar.

Kullanıcılara e-posta iletileri gönderebilmek için, uygulamanızın Web.config dosyasında bir e-posta sunucusu yapılandırmanız gerekir. Daha fazla bilgi için bkz . Nasıl yapılır: IIS 6.0'da SMTP Sanal Sunucularını Yükleme ve Yapılandırma.

<%@ page language="C#"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
  void Changepassword1_SendingMail(object sender, MailMessageEventArgs e)
  {
    // Set mail message fields.
    e.Message.Subject = "New user on Web site.";
    // Replace placeholder text in message body with
    // information provided by the user.
    e.Message.Body = e.Message.Body.Replace("<%ChangedDate%>", (DateTime.Now.ToString()) );
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:changepassword id="Changepassword1" runat="server" 
        maildefinition-bodyfilename="~/MailFiles/mailfile.txt" 
          maildefinition-from="userAdmin@your.site.name.here" 
          onsendingmail="Changepassword1_SendingMail">
      </asp:changepassword>
    </div>
    </form>
</body>
</html>

<%@ page language="VB"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
  Sub Changepassword1_SendingMail(ByVal sender As Object, ByVal e As MailMessageEventArgs)
        ' Set mail message fields.
        e.Message.Subject = "New user on Web site."
        ' Replace placeholder text in message body with information 
        '  provided by the user. 
        e.Message.Body = e.Message.Body.Replace("<%ChangedDate%>", DateTime.Now.ToString())
  End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:changepassword id="Changepassword1" runat="server" 
          maildefinition-bodyfilename="~/MailFiles/mailfile.txt"
          maildefinition-from="userAdmin@your.site.name.here" 
          onsendingmail="Changepassword1_SendingMail">
      </asp:changepassword>
    </div>
    </form>
</body>
</html>

Açıklamalar

özelliği, MailDefinition kullanıcılara parolalarını değiştirdikten sonra gönderilen e-posta iletisinin biçimini ve içeriğini tanımlamak için kullandığınız bir özellik grubuna başvuru döndürür. Sık kullanılan ayarlar konu satırını ve gönderenin iade adresini içerir. Özelliklerin tam listesi için bkz MailDefinition. .

MailDefinition Özelliği salt okunurdur; ancak döndürdüğü nesnenin MailDefinition özelliklerini ayarlayabilirsiniz. Bu özellikleri form özelliği-alt özelliğinde ayarlayabilirsiniz; burada alt özellik sınıfın MailDefinition bir özelliğini temsil eder (örneğin, MailDefinition-Subject). Özellikleri, Özellik.Alt Özelliği (örneğin,MailDefinition.Subject ) biçiminde program aracılığıyla da ayarlayabilirsiniz.

E-posta iletisi yalnızca kullanıcının üyelik sağlayıcısına kayıtlı bir e-posta adresi varsa ve özelliğin MailDefinition özelliği geçerli bir dosyaya işaret ederse BodyFileName gönderilir. BodyFileName Özellik ayarlanırsa, özelliğin From bir e-posta adresine ayarlanması gerekir; aksi takdirde bir HttpException özel durum oluşturulur.

E-posta iletisi nesneden MailDefinition oluşturulduysa, aşağıdaki tabloda gösterilen değiştirmeleri yapar. Değiştirme metni büyük/küçük harfe duyarlı değildir.

Değiştirme metni ile değiştirildi
< UserName%%> Kullanıcının Web sitesi kullanıcı adı.
< parola%%> Kullanıcının yeni parolası.

nesnesinin IsBodyHtmlMailDefinition özelliği ise true, posta iletisinin içeriği, ileti alıcısı için siteler arası betik oluşturma güvenlik açıklarına karşı korunmak üzere HTML ile kodlanır.

nesnesi tarafından MailDefinition oluşturulan nesneyi değiştirmek MailMessage için olayını kullanabilirsinizSendingMail.

Önemli

Kullanıcı hesabı adlarını veya parolalarını e-postayla göndermek olası bir güvenlik tehdididir. E-posta iletileri genellikle düz metin olarak gönderilir ve özel ağ "algılama" uygulamaları tarafından okunabilir. Güvenliği geliştirmek için Oturum Açma Denetimlerinin Güvenliğini Sağlama bölümünde açıklanan risk azaltmalarını kullanın.

Bu özellik temalar veya stil sayfası temaları tarafından ayarlanamaz. Daha fazla bilgi için bkz ThemeableAttribute . Temalar ve Dış Görünümler'i ASP.NET.

Şunlara uygulanır

Ayrıca bkz.