Share via

CreateUserWizard.MailDefinition Properti

  • Referensi

Definisi

Ruang nama:
System.Web.UI.WebControls
Rakitan:
System.Web.dll

Mendapatkan referensi ke kumpulan properti yang menentukan karakteristik pesan email yang dikirim ke pengguna baru.

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

Nilai Properti

MailDefinition

Referensi ke MailDefinition objek yang menentukan pesan email yang dikirim ke pengguna baru.

Atribut
PersistenceModeAttribute ThemeableAttribute

Pengecualian

HttpException

From tidak diatur ke alamat email.

Contoh

Contoh kode berikut mengatur properti MailDefinition properti dengan menggunakan sintaksis deklaratif dan terprogram. Contoh kode ini memerlukan file teks bernama MailFile.txt yang berisi teks berikut.

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>

Keterangan

Properti MailDefinition mengembalikan referensi ke grup properti yang Anda gunakan untuk menentukan format dan konten pesan email yang dikirim ke pengguna baru. Pengaturan umum mencakup baris subjek dan alamat pengembalian pengirim. Untuk daftar lengkap properti, lihat MailDefinition kelas .

Properti MailDefinition bersifat baca-saja; namun, Anda dapat mengatur properti objek yang MailDefinition dikembalikannya. Anda dapat mengatur MailDefinition properti secara deklaratif dalam formulir Property-Subproperty, di mana Subproperty mewakili properti MailDefinition kelas (misalnya, MailDefinition-Subject). Anda juga dapat mengatur properti secara terprogram dalam formulir Property.SubProperty (misalnya, MailDefinition.Subject).

Pesan email dikirim ke pengguna baru hanya jika MailDefinition tidak dan jika Body tidak kosong atau nullnull . Dalam hal ini, SendingMail peristiwa dimunculkan dan upaya dilakukan untuk mengirim pesan email. Properti From harus diatur ke alamat email. Jika tidak, HttpException pengecualian akan dilemparkan.

Saat pesan email dibuat dari MailDefinition objek, pesan tersebut akan membuat substitusi tercantum dalam tabel berikut.

Teks pengganti Diganti dengan
<%UserName%> Nama pengguna akun pengguna yang baru dibuat.
<%Password%> Kata sandi untuk akun pengguna yang baru dibuat.

IsBodyHtml Jika properti MailDefinition objek adalah true, konten pesan email akan dikodekan HTML untuk menjaga dari kerentanan keamanan pembuatan skrip lintas situs untuk penerima pesan.

Anda dapat menggunakan OnSendingMail metode untuk memodifikasi yang MailMessage dibuat oleh MailDefinition objek .

Properti ini tidak dapat diatur oleh tema atau tema lembar gaya. Untuk informasi selengkapnya, lihat ThemeableAttribute dan ASP.NET Tema dan Kulit.

Catatan

Tidak dimungkinkan untuk menjamin bahwa pengguna akan menerima atau melihat pesan email. Untuk memverifikasi bahwa pengguna telah menerima pemberitahuan melalui email, pertimbangkan untuk memberikan tautan konfirmasi dalam pesan email yang memungkinkan pengguna mengonfirmasi bahwa pemberitahuan diterima.

Berlaku untuk

Lihat juga