ChangePassword.MailDefinition Eigenschap

Definitie

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

Hiermee haalt u een verwijzing op naar een verzameling eigenschappen waarmee het e-mailbericht wordt gedefinieerd dat naar gebruikers wordt verzonden nadat ze hun wachtwoord hebben gewijzigd.

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

De From eigenschap is niet ingesteld op een e-mailadres.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de MailDefinition eigenschap gebruikt om een e-mailbericht te definiëren dat wordt verzonden naar gebruikers die hun wachtwoorden wijzigen. Hierbij wordt ervan uitgegaan dat er een bestand MailFile.txt is met de tekst van het e-mailbericht dat moet worden verzonden.

Als u e-mailberichten naar gebruikers wilt kunnen verzenden, moet u een e-mailserver configureren in het Web.config-bestand voor uw toepassing. Zie Procedure: SMTP-virtuele servers installeren en configureren in IIS 6.0 voor meer informatie.

<%@ 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>

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 gebruikers wordt verzonden nadat ze hun wachtwoord hebben gewijzigd. Algemene instellingen zijn onder andere de onderwerpregel en het adres van de afzender. Zie voor een volledige lijst met eigenschappen MailDefinition.

De MailDefinition eigenschap heeft het kenmerk Alleen-lezen. U kunt echter de eigenschappen van het MailDefinition object instellen dat wordt geretourneerd. U kunt deze eigenschappen instellen in desubeigenschap van de -, waarbij subproperty een eigenschap van de MailDefinition klasse vertegenwoordigt (bijvoorbeeldMailDefinition-Subject). U kunt de eigenschappen ook programmatisch instellen in de subeigenschap van de formuliereigenschap. (bijvoorbeeld).MailDefinition.Subject

Er wordt alleen een e-mailbericht verzonden als de gebruiker een e-mailadres heeft dat is geregistreerd bij de lidmaatschapsprovider en als de BodyFileName eigenschap van de MailDefinition eigenschap verwijst naar een geldig bestand. Als de BodyFileName eigenschap is ingesteld, moet de From eigenschap worden ingesteld op een e-mailadres. Anders wordt er een HttpException uitzondering gegenereerd.

Als het e-mailbericht wordt gemaakt op basis van het MailDefinition object, worden de vervangingen weergegeven in de volgende tabel. De vervangingstekst is niet hoofdlettergevoelig.

Vervangingstekst Vervangen door
< UserName%%> De gebruikersnaam van de website van de gebruiker.
<%wachtwoord%> Het nieuwe wachtwoord voor de gebruiker.

Als de IsBodyHtml eigenschap van het MailDefinition object is true, wordt de inhoud van het e-mailbericht html-gecodeerd om beveiliging van beveiligingsproblemen voor de ontvanger van het bericht te beschermen tegen beveiligingsproblemen op meerdere sites.

U kunt de SendingMail gebeurtenis gebruiken om het MailMessage object te wijzigen dat door het MailDefinition object is gemaakt.

Important

Het verzenden van gebruikersaccountnamen of wachtwoorden in e-mail is een mogelijke beveiligingsrisico. E-mailberichten worden meestal in tekst zonder opmaak verzonden en kunnen worden gelezen door speciale netwerktoepassingen voor 'sniffing'. Gebruik de oplossingen die worden beschreven in Aanmeldingsbesturingselementen beveiligen om de beveiliging te verbeteren.

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

Van toepassing op

Zie ook