CreateUserWizard.MailDefinition Eigenschap

Definitie

Naamruimte:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Hiermee haalt u een verwijzing op naar een verzameling eigenschappen die de kenmerken van het e-mailbericht definiëren dat naar nieuwe gebruikers wordt verzonden.

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

Waarde van eigenschap

MailDefinition

Een verwijzing naar een MailDefinition object dat het e-mailbericht definieert dat naar een nieuwe gebruiker wordt verzonden.

Kenmerken
PersistenceModeAttribute ThemeableAttribute

Uitzonderingen

HttpException

From is niet ingesteld op een e-mailadres.

Voorbeelden

In het volgende codevoorbeeld worden eigenschappen van de MailDefinition eigenschap ingesteld met behulp van zowel declaratieve als programmatische syntaxis. Voor dit codevoorbeeld is een tekstbestand met de naam MailFile.txt met de volgende tekst vereist.

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>

Opmerkingen

De MailDefinition eigenschap retourneert een verwijzing naar een groep eigenschappen die u gebruikt om de indeling en inhoud van het e-mailbericht te definiëren dat naar nieuwe gebruikers wordt verzonden. Algemene instellingen zijn onder andere de onderwerpregel en het adres van de afzender. Zie de MailDefinition klasse voor een volledige lijst met eigenschappen.

De MailDefinition eigenschap heeft het kenmerk Alleen-lezen. U kunt echter de eigenschappen van het MailDefinition object instellen dat wordt geretourneerd. U kunt de MailDefinition eigenschappen declaratief instellen in het formulier Property-Subproperty, waarbij een Subproperty eigenschap van de MailDefinition klasse wordt aangegeven (bijvoorbeeld MailDefinition-Subject). U kunt de eigenschappen ook programmatisch instellen in het formulier Property.SubProperty (bijvoorbeeld MailDefinition.Subject).

Er wordt alleen een e-mailbericht naar nieuwe gebruikers verzonden als MailDefinition dat niet null zo is en als Body dit niet leeg is of null. In dat geval wordt de SendingMail gebeurtenis gegenereerd en wordt geprobeerd het e-mailbericht te verzenden. De From eigenschap moet worden ingesteld op een e-mailadres. Anders wordt er een HttpException uitzondering gegenereerd.

Wanneer het e-mailbericht wordt gemaakt op basis van het MailDefinition object, worden de vervangingen weergegeven in de volgende tabel.

Vervangingstekst Vervangen door
<%UserName%> De gebruikersnaam van het zojuist gemaakte gebruikersaccount.
<%Password%> Het wachtwoord voor het zojuist gemaakte gebruikersaccount.

Als de IsBodyHtml eigenschap van het MailDefinition object is true, wordt de inhoud van het e-mailbericht gecodeerd met HTML- codering tegen beveiligingsproblemen op meerdere sites voor de geadresseerde van het bericht.

U kunt de OnSendingMail methode gebruiken om de MailMessage gemaakt door het MailDefinition object te wijzigen.

Deze eigenschap kan niet worden ingesteld op thema's of opmaakmodellen. Zie ThemeableAttribute en ASP.NET Thema's en skins voor meer informatie.

Note

Het is niet mogelijk om te garanderen dat een gebruiker een e-mailbericht ontvangt of bekijkt. Als u wilt controleren of een gebruiker per e-mail een melding heeft ontvangen, kunt u een bevestigingskoppeling instellen in het e-mailbericht waarmee de gebruiker kan bevestigen dat de melding is ontvangen.

Van toepassing op

Zie ook