Bagikan melalui

ChangePassword.MailDefinition Properti

  • Referensi

Definisi

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

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 objek MailDefinition 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 properti MailDefinition 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 yang akan 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 MailDefinition yang dikembalikannya. Anda dapat mengatur properti ini dalam properti formulir -subproperti, di mana subproperti mewakili properti kelas MailDefinition (misalnya, MailDefinition-Subject). Anda juga dapat mengatur properti secara terprogram dalam formulir Properti. Subproperti (misalnya,MailDefinition.Subject).

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

Jika pesan email dibuat dari objek MailDefinition, 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.
% Kata Sandi % Kata sandi baru untuk pengguna.

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

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

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 Tema ThemeableAttribute dan ASP.NET dan Skins.

Berlaku untuk

Lihat juga