Sdílet prostřednictvím

Gewusst wie: Verwenden erweiterter Features des ASP.NET-Anmeldesteuerelements

  • Článek

Aktualisiert: November 2007

Das Login-Steuerelement ist ein zusammengesetztes Steuerelement, das alle gängigen Benutzeroberflächenelemente eines Anmeldeformulars enthält. Das Steuerelement ist modular strukturiert, und die verschiedenen Module können einzeln angepasst werden. Diese Module beinhalten die Textfelder Benutzername und Kennwort, die Schaltfläche zum Senden, die Schaltfläche zum Erstellen neuer Benutzer, das Kontrollkästchen Anmeldedaten speichern und Hilfeinformationen für den Benutzer. Sie können eine eigene Benutzeroberfläche für Anmeldesteuerelemente erstellen, indem Sie neue Elemente definieren und Standardkomponenten wieder verwenden. Weiterhin haben Sie die Möglichkeit, Text und Darstellung der Benutzeroberfläche (Schriftarten und Farben) des Login-Steuerelements anzupassen. Sie können auch die Gesamtdarstellung des Login-Steuerelements ändern, indem Sie das ASP.NET-Design (Theme oder Skin) anwenden.

Mithilfe erweiterter Funktionen des Login-Steuerelements können Sie beispielsweise festlegen, ob die Anmeldeinformationen in einem dauerhaften Cookie des Browsers gespeichert werden oder die Anmeldeseite für angemeldete Benutzer (bei anderen als der Standardanmeldeseite) angezeigt wird. Schließlich können Sie das Anmeldesteuerelement in eine Vorlage konvertieren, um die Darstellung des Steuerelements dauerhaft festzulegen.

So steuern Sie, ob das Anmeldesteuerelement angezeigt wird, wenn ein Benutzer angemeldet ist

  1. Platzieren Sie ein Login-Steuerelement auf einer Seite.

    ms178340.alert_note(de-de,VS.90).gifHinweis:

    Standardmäßig wird das Steuerelement für die Anmeldeseite Login.aspx konfiguriert. Der Name der Anmeldeseite in der Datei Web.config kann durch Festlegen der LoginUrl-Eigenschaft der FormsAuthentication-Klasse geändert werden.

  2. Wenn das Login-Steuerelement nur angezeigt werden soll, wenn ein Benutzer nicht angemeldet ist (das Steuerelement wird immer auf der von der LoginUrl-Eigenschaft identifizierten Anmeldeseite angezeigt), legen Sie die VisibleWhenLoggedIn-Eigenschaft auf false fest.

  1. Wenn im Steuerelement das Kontrollkästchen Anmeldedaten speichern angezeigt werden soll, legen Sie die DisplayRememberMe-Eigenschaft auf true fest. Wenn Benutzer bei der Anmeldung das Kontrollkästchen Anmeldedaten speichern aktivieren, wird das Authentifizierungstoken in einem dauerhaften Cookie im Browser gespeichert.

  2. Wenn das Kontrollkästchen Anmeldedaten speichern in der Standardeinstellung aktiviert sein soll, legen Sie die RememberMeSet-Eigenschaft auf true fest.

  3. Wenn das Authentifizierungstoken in einem dauerhaften Cookie gespeichert werden soll, ohne dass der Benutzer das Kontrollkästchen Anmeldedaten speichern deaktivieren kann, legen Sie dieRememberMeSet-Eigenschaft auf true fest, und legen Sie die DisplayRememberMe-Eigenschaft auf false fest. Diese Vorgehensweise wird nicht für Websites empfohlen, auf die von öffentlichen Computern aus zugegriffen werden kann, die von mehreren Benutzern verwendet werden, da das dauerhafte Authentifizierungstoken eines Benutzers von einem unerwünschten Benutzer verwendet werden könnte.

So fügen Sie dem Anmeldesteuerelement Hilfeverknüpfungen hinzu

  1. Wenn Sie dem Login-Steuerelement eine Verknüpfung hinzufügen möchten, über die Benutzer an eine URL weitergeleitet werden, an der ein neues Benutzerkonto erstellt werden kann, legen Sie die CreateUserText-Eigenschaft auf einen Text fest, z. B. Click here to register, und legen Sie die CreateUserUrl-Eigenschaft auf die URL der Hilfeseite fest, z. B. ~/register.aspx.

    ms178340.alert_note(de-de,VS.90).gifHinweis:

    Für diesen und die folgenden Schritte ist es erforderlich, dass die Ziel-URLs ohne Authentifizierung aufgerufen werden können.

  2. Wenn Sie dem Login-Steuerelement eine Verknüpfung hinzufügen möchten, über die Benutzer an eine URL weitergeleitet werden, an dem das Kennwort wiederhergestellt werden kann, legen Sie die PasswordRecoveryText-Eigenschaft auf einen Text fest, z. B. Forgot your password?, und legen Sie die PasswordRecoveryUrl-Eigenschaft auf die URL der Hilfeseite fest, z. B. ~/recoverpassword.aspx.

  3. Wenn Sie dem Login-Steuerelement eine Verknüpfung hinzufügen möchten, über den der Benutzer an eine Hilfe-URL weitergeleitet wird, legen Sie die HelpPageText-Eigenschaft auf einen Text fest, z. B. Need Help?, und legen Sie die HelpPageUrl-Eigenschaft auf die URL der Hilfeseite fest, z. B. ~/userhelp.aspx.

So fügen Sie dem Anmeldesteuerelement Bilder hinzu

  • Zum Verwenden eines Bilds anstelle der Schaltfläche Anmelden legen Sie die LoginButtonImageUrl-Eigenschaft auf die URL der Anmeldebilddatei fest, z. B. ~/images/login.gif.

    Sie können auch Bilder in die Verknüpfungen einschließen, um mithilfe der Eigenschaften PasswordRecoveryIconUrl, CreateUserIconUrl bzw. HelpPageIconUrl die Benutzer-URL, die Kennwortwiederherstellungs-URL und die Hilfe-URL zu erstellen.

Konvertieren des Anmeldesteuerelements in eine Vorlage

Das Login-Steuerelement kann in eine im Markup als Tabelle definierte Vorlage konvertiert werden, die ASP.NET-Steuerelemente enthält, wie z. B. Label und TextBox. Anschließend können Sie diese Elemente verwenden oder eigene hinzufügen, um eine benutzerdefinierte Vorlage für das Login-Steuerelement zu erstellen. Beachten Sie, dass für die Steuerelemente, aus denen sich die Anmeldevorlage zusammensetzt, die gleichen Steuerelement-IDs wie in der Standardvorlage verwendet werden.

So verwenden Sie eine Vorlage für das Anmeldesteuerelement

  1. Fügen Sie in der Entwurfsansicht ein Login-Steuerelement auf einer Seite ein.

  2. Klicken Sie mit der rechten Maustaste auf das Steuerelement, und wählen Sie im Kontextmenü In Vorlage konvertieren aus.

Die Art der Konvertierung des Login-Steuerelements hängt von der DOCTYPE-Deklaration ab. Wenn die DOCTYPE-Deklaration auf XHTML 1.0 Transitional (<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">) festgelegt ist, werden Formate auf eine Tabelle angewendet, die beim Konvertieren des Login-Steuerelements in eine Vorlage erstellt wird. Wenn die DOCTYPE-Deklaration nicht auf XHTML 1.0 Transitional festgelegt oder nicht vorhanden ist, werden keine Formatierungsinformationen beim Generieren der äußeren Tabelle beibehalten.

Wenn Sie beispielsweise die relative Schriftgröße für das Login-Steuerelement festlegen und das Steuerelement anschließend in eine Vorlage konvertieren, wird die relative Schriftgröße in der Tabelle nicht beibehalten. Das folgende Beispiel zeigt ein Login-Steuerelement mit einer Schriftgröße, die auf X-Groß festgelegt wird.

<asp:login id="Login2" runat="server" font-size="X-Large" BackColor="#F7F6F3" BorderColor="#E6E2D8" BorderPadding="4" BorderStyle="Solid" BorderWidth="1px" Font-Names="Verdana" ForeColor="#333333">
    <TitleTextStyle BackColor="#5D7B9D" Font-Bold="True" Font-Size="0.9em" ForeColor="White" />
    <InstructionTextStyle Font-Italic="True" ForeColor="Black" />
   <TextBoxStyle Font-Size="0.8em" />
    <LoginButtonStyle BackColor="#FFFBFF" BorderColor="#CCCCCC" BorderStyle="Solid" BorderWidth="1px"
    Font-Names="Verdana" Font-Size="0.8em" ForeColor="#284775" />
</asp:login>

Wenn das Login-Steuerelement aus dem oben aufgeführten Code in eine Vorlage konvertiert wird, werden auf die erstellte Tabelle keine Formatierungen angewendet. Im Folgenden ist ein Ausschnitt aus dem Code aufgeführt, der aus dem oben dargestellten Steuerelement bei der Konvertierung in eine Vorlage generiert wird.

<asp:login id="Login2" runat="server" font-size="X-Large" BackColor="#F7F6F3" BorderColor="#E6E2D8" BorderPadding="4" BorderStyle="Solid" BorderWidth="1px" Font-Names="Verdana" ForeColor="#333333">
    <TitleTextStyle BackColor="#5D7B9D" Font-Bold="True" Font-Size="0.9em" ForeColor="White" />
    <InstructionTextStyle Font-Italic="True" ForeColor="Black" />
    <TextBoxStyle Font-Size="0.8em" />
    <LoginButtonStyle BackColor="#FFFBFF" BorderColor="#CCCCCC" BorderStyle="Solid" BorderWidth="1px"
    Font-Names="Verdana" Font-Size="0.8em" ForeColor="#284775" />
    <LayoutTemplate>
    <table border="0" cellpadding="4" cellspacing="0" style="border-collapse: collapse">
...

Wenn die Formatattribute für die bei der Konvertierung des Login-Steuerelements in eine Vorlage erstellte Tabelle ebenfalls gelten sollen, vergewissern Sie sich, dass die DOCTYPE-Deklaration der Seite auf XHTML 1.0 Transitional festgelegt ist, bevor Sie In Vorlage konvertieren in der Entwurfsansicht im Steuerelementmenü auswählen.

Siehe auch

Konzepte

Anpassen der Darstellung von ASP.NET-Anmeldesteuerelementen

Übersicht über ASP.NET-Designs und ASP.NET-Skins

Weitere Ressourcen

Toolbox-Anmeldesteuerelemente