ChangePassword.MailDefinition Properti

Referensi

Definisi

Ruang nama:: System.Web.UI.WebControls

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mendapatkan referensi ke kumpulan properti yang menentukan pesan email yang dikirim ke pengguna setelah mereka mengubah kata sandi mereka.

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

Properti From tidak diatur ke alamat email.

Contoh

Contoh kode berikut menunjukkan cara menggunakan MailDefinition properti untuk menentukan pesan email yang dikirim ke pengguna yang mengubah kata sandi mereka. Ini mengasumsikan bahwa ada file yang disebut MailFile.txt yang berisi teks pesan email untuk dikirim.

Agar dapat mengirim pesan email kepada pengguna, Anda harus mengonfigurasi server email di file Web.config untuk aplikasi Anda. Untuk informasi selengkapnya, lihat Cara: Menginstal dan Mengonfigurasi Server Virtual SMTP di IIS 6.0.

<%@ 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>

Keterangan

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

Properti MailDefinition bersifat baca-saja; namun, Anda dapat mengatur properti objek yang MailDefinition dikembalikannya. Anda dapat mengatur properti ini dalamsubpropertiproperti- formulir, di mana subproperti mewakili properti MailDefinition kelas (misalnya, MailDefinition-Subject). Anda juga dapat mengatur properti secara terprogram dalam formulirSubpropertiProperti. (misalnya,MailDefinition.Subject).

Pesan email dikirim hanya jika pengguna memiliki alamat email yang terdaftar di penyedia keanggotaan dan jika BodyFileName properti MailDefinition properti menunjuk ke file yang valid. BodyFileName Jika properti diatur, From properti harus diatur ke alamat email; jika tidak, HttpException pengecualian akan dilemparkan.

Jika pesan email dibuat dari MailDefinition objek, pesan tersebut akan membuat substitusi diperlihatkan dalam tabel berikut. Teks substitusi tidak peka huruf besar/kecil.

Teks pengganti	Diganti dengan
<%`UserName`%>	Nama pengguna situs Web pengguna.
<%Password%>	Kata sandi baru untuk pengguna.

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

Anda dapat menggunakan SendingMail peristiwa untuk mengubah MailMessage objek yang dibuat oleh MailDefinition objek.

Penting

Mengirim nama akun pengguna atau kata sandi dalam email adalah potensi ancaman keamanan. Pesan email biasanya dikirim dalam teks biasa dan dapat dibaca oleh aplikasi "sniffing" jaringan khusus. Untuk meningkatkan keamanan, gunakan mitigasi yang dijelaskan dalam Mengamankan Kontrol Masuk.

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

Berlaku untuk

Bagikan melalui