CreateUserWizard.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, które definiują charakterystykę wiadomości e-mail wysyłanej do nowych użytkowników.

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 MailDefinition obiektu definiującego wiadomość e-mail wysłaną do nowego użytkownika.

Atrybuty
PersistenceModeAttribute ThemeableAttribute

Wyjątki

HttpException

From nie jest ustawiona na adres e-mail.

Przykłady

Poniższy przykład kodu ustawia właściwości MailDefinition właściwości przy użyciu składni deklaratywnej i programowej. Ten przykładowy kod wymaga pliku tekstowego o nazwie MailFile.txt zawierającego następujący tekst.

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>

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 nowych użytkowników. Typowe ustawienia obejmują wiersz tematu i adres zwrotny nadawcy. Aby uzyskać pełną listę właściwości, zobacz klasę MailDefinition .

Właściwość MailDefinition jest tylko do odczytu, ale można ustawić właściwości zwracanego MailDefinition obiektu. Właściwości można ustawić MailDefinition deklaratywnie w postaci Property-Subproperty, gdzie Subproperty reprezentuje właściwość MailDefinition klasy (na przykład MailDefinition-Subject). Właściwości można również ustawić programowo w formularzu Property.SubProperty (na przykład MailDefinition.Subject).

Wiadomość e-mail jest wysyłana do nowych użytkowników tylko wtedy, gdy MailDefinition nie null jest i jeśli Body nie jest pusta lub null. W takim przypadku SendingMail zdarzenie jest zgłaszane i podejmowana jest próba wysłania wiadomości e-mail. Właściwość musi być ustawiona From na adres e-mail. W przeciwnym razie zgłaszany HttpException jest wyjątek.

Po utworzeniu MailDefinition wiadomości e-mail na podstawie obiektu zostaną zastąpione wymienione w poniższej tabeli.

Tekst podstawienia Zamieniono na
<%UserName%> Nazwa użytkownika nowo utworzonego konta użytkownika.
<%Password%> Hasło dla nowo utworzonego konta użytkownika.

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

Możesz użyć OnSendingMail metody , aby zmodyfikować MailMessage utworzony przez MailDefinition obiekt .

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 ThemeableAttributei ASP.NET Motywy i skórki.

Uwaga

Nie można zagwarantować, że użytkownik otrzyma lub wyświetli wiadomość e-mail. Aby sprawdzić, czy użytkownik otrzymał powiadomienie pocztą e-mail, rozważ podanie linku potwierdzenia w wiadomości e-mail, która umożliwia użytkownikowi potwierdzenie odebrania powiadomienia.

Dotyczy

Zobacz też