Aracılığıyla paylaş

ChangePassword.MailDefinition Özellik

  • Başvuru

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ğinin MailDefinition parolalarını değiştiren kullanıcılara gönderilen bir e-posta iletisini tanımlamak için nasıl kullanılacağını 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 parolalarını değiştirdikten sonra kullanıcılara 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. Genel 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, alt özelliğinsınıfın bir özelliğini temsil ettiği form özelliği -alt özelliğinde MailDefinition ayarlayabilirsiniz (ö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 BodyFileNameMailDefinition özelliği geçerli bir dosyaya işaret ederse gönderilir. BodyFileName Özellik ayarlandıysa, ö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 şununla değiştirildi:
<%UserName%> Kullanıcının Web sitesi kullanıcı adı.
<%Password%> 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. Email 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ı 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 ASP.NET.

Şunlara uygulanır

Ayrıca bkz.