CreateUserWizard.MailDefinition Vlastnost

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Získá odkaz na kolekci vlastností, které definují charakteristiky e-mailové zprávy odeslané novým uživatelům.

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

Hodnota vlastnosti

MailDefinition

Odkaz na MailDefinition objekt, který definuje e-mailovou zprávu odeslanou novému uživateli.

Atributy
PersistenceModeAttribute ThemeableAttribute

Výjimky

HttpException

From není nastavená na e-mailovou adresu.

Příklady

Následující příklad kódu nastaví vlastnosti MailDefinition vlastnosti pomocí deklarativní i programové syntaxe. Tento příklad kódu vyžaduje textový soubor s názvem MailFile.txt, který obsahuje následující text.

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>

Poznámky

Vlastnost MailDefinition vrátí odkaz na skupinu vlastností, které slouží k definování formátu a obsahu e-mailové zprávy odesílané novým uživatelům. Mezi běžná nastavení patří řádek předmětu a zpáteční adresa odesílatele. Úplný seznam vlastností najdete v MailDefinition třídě.

Vlastnost MailDefinition je jen pro čtení, ale můžete nastavit vlastnosti objektu, který MailDefinition vrací. Vlastnosti můžete deklarativně nastavit MailDefinition ve formuláři Property-Subproperty, kde Subproperty představuje vlastnost MailDefinition třídy (například MailDefinition-Subject). Vlastnosti můžete také nastavit programově ve formuláři Property.SubProperty (například MailDefinition.Subject).

E-mailová zpráva se odešle novým uživatelům pouze v případě MailDefinition , že není null a pokud Body není prázdná nebo null. V takovém případě SendingMail se událost vyvolá a pokusí se odeslat e-mailovou zprávu. Vlastnost From musí být nastavená na e-mailovou adresu. V opačném případě dojde k výjimce HttpException .

Když je e-mailová zpráva vytvořena z objektu MailDefinition , provede nahrazení uvedené v následující tabulce.

Text nahrazení Nahrazeno za
<%UserName%> Uživatelské jméno nově vytvořeného uživatelského účtu.
<%Password%> Heslo k nově vytvořenému uživatelskému účtu.

IsBodyHtml Pokud je truevlastnost objektu MailDefinition , obsah e-mailové zprávy bude kódován ve formátu HTML, aby byl chráněn před ohroženími zabezpečení skriptování mezi weby pro příjemce zprávy.

Můžete použít metodu OnSendingMail k úpravě objektu MailMessage vytvořeného objektem MailDefinition .

Tuto vlastnost nelze nastavit pomocí motivů nebo šablon stylů. Další informace najdete v tématu ThemeableAttribute a ASP.NET motivy a vzhledy.

Poznámka

Není možné zaručit, že uživatel obdrží nebo zobrazí e-mailovou zprávu. Pokud chcete ověřit, že uživatel obdržel oznámení e-mailem, zvažte možnost poskytnout v e-mailové zprávě potvrzovací odkaz, který uživateli umožní potvrdit přijetí oznámení.

Platí pro

Viz také