CreateUserWizard.MailDefinition Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft einen Verweis auf eine Auflistung von Eigenschaften ab, durch die die Merkmale der E-Mail definiert werden, die an neue Benutzer gesendet wird.

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

Eigenschaftswert

MailDefinition

Ein Verweis auf ein MailDefinition -Objekt, das die E-Mail-Nachricht definiert, die an einen neuen Benutzer gesendet wird.

Attribute: PersistenceModeAttribute ThemeableAttribute

Ausnahmen

HttpException

From wird nicht auf eine E-Mail-Adresse festgelegt.

Beispiele

Im folgenden Codebeispiel werden eigenschaften der MailDefinition -Eigenschaft sowohl mit deklarativer als auch mit programmgesteuerter Syntax festgelegt. Dieses Codebeispiel erfordert eine Textdatei namens MailFile.txt, die den folgenden Text enthält.

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>

Hinweise

Die MailDefinition -Eigenschaft gibt einen Verweis auf eine Gruppe von Eigenschaften zurück, die Sie verwenden, um das Format und den Inhalt der E-Mail-Nachricht zu definieren, die an neue Benutzer gesendet wird. Häufige Einstellungen sind die Betreffzeile und die Absender-Rückgabeadresse. Eine vollständige Liste der Eigenschaften finden Sie in der MailDefinition -Klasse.

Die MailDefinition Eigenschaft ist schreibgeschützt; Sie können jedoch festlegen, die Eigenschaften der MailDefinition -Objekt wird zurückgegeben. Sie können die MailDefinition Eigenschaften deklarativ im Format Property-Subpropertyfestlegen, MailDefinition-Subjectwobei Subproperty eine Eigenschaft der MailDefinition -Klasse darstellt (z. B. ). Sie können die Eigenschaften auch programmgesteuert im Formular Property.SubProperty festlegen (z. B. MailDefinition.Subject).

Eine E-Mail-Nachricht wird nur dann an neue Benutzer gesendet, wenn MailDefinition nicht und wenn Body nicht leer oder nullnull ist. In diesem Fall wird das SendingMail Ereignis ausgelöst, und es wird versucht, die E-Mail-Nachricht zu senden. Die From -Eigenschaft muss auf eine E-Mail-Adresse festgelegt werden. Andernfalls wird eine HttpException Ausnahme ausgelöst.

Wenn die E-Mail-Nachricht aus dem MailDefinition -Objekt erstellt wird, werden die in der folgenden Tabelle aufgeführten Ersetzungen vorgenommen.

Ersetzungstext	Ersetzt durch
`<%UserName%>`	Der Benutzername des neu erstellten Benutzerkontos.
`<%Password%>`	Das Kennwort für das neu erstellte Benutzerkonto.

Wenn die IsBodyHtml -Eigenschaft des MailDefinition -Objekts lautet true, wird der Inhalt der E-Mail-Nachricht HTML-codiert, um sicherheitsrelevante Sicherheitsrisiken beim Websiteskripting für den Nachrichtenempfänger zu schützen.

Sie können die OnSendingMail -Methode verwenden, um die MailMessage vom MailDefinition -Objekt erstellte zu ändern.

Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und ASP.NET-Designs und Skins.

Hinweis

Es ist nicht möglich, zu garantieren, dass ein Benutzer eine E-Mail-Nachricht empfängt oder einsehen wird. Um zu überprüfen, ob ein Benutzer eine Benachrichtigung per E-Mail erhalten hat, sollten Sie einen Bestätigungslink in der E-Mail-Nachricht angeben, über den der Benutzer bestätigen kann, dass die Benachrichtigung empfangen wurde.

Gilt für: