Udostępnij za pośrednictwem

ChangePassword.MailDefinition Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls
Zestaw:
System.Web.dll

Pobiera odwołanie do kolekcji właściwości definiujących wiadomość e-mail, która jest wysyłana do użytkowników po zmianie hasła.

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

Wartość właściwości

MailDefinition

Odwołanie do obiektu MailDefinition definiującego wiadomość e-mail wysłaną do nowego użytkownika.

Atrybuty
PersistenceModeAttribute ThemeableAttribute

Wyjątki

HttpException

Właściwość From nie jest ustawiona na adres e-mail.

Przykłady

Poniższy przykład kodu przedstawia sposób użycia właściwości MailDefinition w celu zdefiniowania wiadomości e-mail wysyłanej do użytkowników, którzy zmieniają swoje hasła. Przyjęto założenie, że istnieje plik o nazwie MailFile.txt zawierający tekst wiadomości e-mail do wysłania.

Aby móc wysyłać wiadomości e-mail do użytkowników, należy skonfigurować serwer poczty e-mail w pliku Web.config dla aplikacji. Aby uzyskać więcej informacji, zobacz Instrukcje: instalowanie i konfigurowanie serwerów wirtualnych SMTP w usługach 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>

Uwagi

Właściwość MailDefinition zwraca odwołanie do grupy właściwości używanych do definiowania formatu i zawartości wiadomości e-mail wysyłanej do użytkowników po zmianie hasła. Typowe ustawienia obejmują wiersz tematu i adres zwrotny nadawcy. Aby uzyskać pełną listę właściwości, zobacz MailDefinition.

Właściwość MailDefinition jest tylko do odczytu; można jednak ustawić właściwości zwracanego obiektu MailDefinition. Te właściwości można ustawić w właściwości formularza-podwłaściwości, gdzie podwłaściwość reprezentuje właściwość klasy MailDefinition (na przykład MailDefinition-Subject). Właściwości można również ustawić programowo w formularzu Property.Subproperty (na przykładMailDefinition.Subject).

Wiadomość e-mail jest wysyłana tylko wtedy, gdy użytkownik ma adres e-mail zarejestrowany u dostawcy członkostwa, a właściwość BodyFileName właściwości MailDefinition wskazuje prawidłowy plik. Jeśli właściwość BodyFileName jest ustawiona, właściwość From musi być ustawiona na adres e-mail; w przeciwnym razie jest zgłaszany wyjątek HttpException.

Jeśli wiadomość e-mail zostanie utworzona na podstawie obiektu MailDefinition, spowoduje to zastąpienie pokazane w poniższej tabeli. Tekst podstawienia jest niewrażliwy na wielkość liter.

Tekst podstawienia Zamieniono na
<%UserName%> Nazwa użytkownika witryny sieci Web.
<%hasło%> Nowe hasło użytkownika.

Jeśli właściwość IsBodyHtml obiektu MailDefinition jest true, zawartość wiadomości e-mail będzie zakodowana w formacie HTML w celu ochrony przed lukami w zabezpieczeniach zabezpieczeń skryptów między witrynami dla adresata wiadomości.

Zdarzenie SendingMail służy do modyfikowania obiektu MailMessage utworzonego przez obiekt MailDefinition.

Ważny

Wysyłanie nazw kont użytkowników lub haseł w wiadomości e-mail jest potencjalnym zagrożeniem bezpieczeństwa. Wiadomości e-mail są zwykle wysyłane w postaci zwykłego tekstu i mogą być odczytywane przez specjalne aplikacje sieciowe "wąchanie". Aby zwiększyć bezpieczeństwo, należy użyć środków zaradczych opisanych w Zabezpieczanie kontrolek logowania.

Tej właściwości nie można ustawić za pomocą motywów ani motywów arkusza stylów. Aby uzyskać więcej informacji, zobacz ThemeableAttribute i ASP.NET Motywy i skórki.

Dotyczy

Zobacz też