CreateUserWizard.MailDefinition Özellik

  • Başvuru

Tanım

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

Yeni kullanıcılara gönderilen e-posta iletisinin özelliklerini 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 e-posta adresine ayarlanmadı.

Örnekler

Aşağıdaki kod örneği, hem bildirim temelli hem de programlı söz dizimi kullanarak özelliğin MailDefinition özelliklerini ayarlar. Bu kod örneği, aşağıdaki metni içeren MailFile.txt adlı bir metin dosyası gerektirir.

Your account was set up on our Web site with the following:

    Username:   <%UserName%>

To reset your password, you must answer the following question:

    Password Question: <%PasswordQuestion%>
    Password Answer:   <%PasswordAnswer%>

Thank you for creating an account with our Web site.

<%@ 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 Createuserwizard1_SendingMail(object sender, MailMessageEventArgs e)
  {
    // Set MailMessage fields.
    e.Message.IsBodyHtml = false;
    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("<%PasswordQuestion%>", Createuserwizard1.Question);
    e.Message.Body = e.Message.Body.Replace("<%PasswordAnswer%>",   Createuserwizard1.Answer);  
}
  
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>
      CreateUserWizard.MailDefinition sample</title>
  </head>
  <body>
    <form id="form1" runat="server">
      <div>
        <asp:createuserwizard id="Createuserwizard1" runat="server" 
          maildefinition-bodyfilename="MailFile.txt"
          maildefinition-from="userAdmin@your.site.name.here" 
          onsendingmail="Createuserwizard1_SendingMail">
        </asp:createuserwizard>
      </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 Createuserwizard1_SendingMail(ByVal sender As Object, ByVal e As MailMessageEventArgs)
    ' Set MailMessage fields.
    e.Message.IsBodyHtml = False
    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("<%PasswordQuestion%>", Createuserwizard1.Question)
    e.Message.Body = e.Message.Body.Replace("<%PasswordAnswer%>",   Createuserwizard1.Answer)
  End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>
      CreateUserWizard.MailDefinition sample</title>
  </head>
  <body>
    <form id="form1" runat="server">
      <div>
        <asp:createuserwizard id="Createuserwizard1" runat="server" 
          maildefinition-bodyfilename="MailFile.txt"
          maildefinition-from="userAdmin@your.site.name.here" 
          onsendingmail="Createuserwizard1_SendingMail">
        </asp:createuserwizard>
      </div>
    </form>
  </body>
</html>

Açıklamalar

özelliği, MailDefinition yeni 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 sınıfına MailDefinition bakın.

MailDefinition Özelliği salt okunurdur; ancak döndürdüğü nesnenin MailDefinition özelliklerini ayarlayabilirsiniz. Özellikleri biçiminde bildirimli olarak ayarlayabilirsinizMailDefinition; burada Subproperty sınıfının bir özelliğini MailDefinition temsil eder (örneğin, MailDefinition-Subject).Property-Subproperty Ayrıca, özellikleri program aracılığıyla biçiminde Property.SubProperty de ayarlayabilirsiniz (örneğin, MailDefinition.Subject).

Yeni kullanıcılara e-posta iletisi yalnızca MailDefinitionnull boş değilse ve boş değilse Body veya nullgönderilir. Bu durumda olay SendingMail oluşturulur ve e-posta iletisini gönderme girişiminde bulunulur. Özelliğin From bir e-posta adresine ayarlanması gerekir. Aksi takdirde, bir HttpException özel durum oluşturulur.

Nesneden MailDefinition e-posta iletisi oluşturulduğunda, değiştirmelerin aşağıdaki tabloda listelenmiş olmasını sağlar.

Değiştirme metni şununla değiştirildi:
<%UserName%> Yeni oluşturulan kullanıcı hesabının kullanıcı adı.
<%Password%> Yeni oluşturulan kullanıcı hesabının 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 olarak kodlanır.

nesnesinin OnSendingMailMailDefinition oluşturduğu öğesini MailMessage değiştirmek için yöntemini kullanabilirsiniz.

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.

Not

Kullanıcının bir e-posta iletisi alacağını veya görüntüleyip görüntülemeyeceğini garanti etmek mümkün değildir. Kullanıcının e-postayla bildirim aldığını doğrulamak için, e-posta iletisinde kullanıcının bildirimin alındığını onaylamasını sağlayan bir onay bağlantısı sağlamayı göz önünde bulundurun.

Şunlara uygulanır

Ayrıca bkz.