Login Login Login Login Class

Definition

Stellt Benutzeroberflächenelemente zum Anmelden an einer Website bereit.Provides user interface (UI) elements for logging in to a Web site.

public ref class Login : System::Web::UI::WebControls::CompositeControl
[System.ComponentModel.Bindable(false)]
public class Login : System.Web.UI.WebControls.CompositeControl
type Login = class
    inherit CompositeControl
Public Class Login
Inherits CompositeControl
Vererbung
Attribute

Beispiele

Im folgenden Codebeispiel wird ein Login -Steuerelement verwendet, um eine Benutzeroberfläche für die Anmeldung bei einer Website bereitzustellen.The following code example uses a Login control to provide a UI for logging in to a Web site.

<%@ Page Language="C#" %>
<%@ Import Namespace="System.ComponentModel" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
bool IsValidEmail(string strIn)
{
    // Return true if strIn is in valid email format.
    return Regex.IsMatch(strIn, @"^([\w-\.]+)@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.)|(([\w-]+\.)+))([a-zA-Z]{2,4}|[0-9]{1,3})(\]?)$"); 
}

void OnLoggingIn(object sender, System.Web.UI.WebControls.LoginCancelEventArgs e)
{
    if (!IsValidEmail(Login1.UserName))
    {
        Login1.InstructionText = "Enter a valid email address.";
        Login1.InstructionTextStyle.ForeColor = System.Drawing.Color.RosyBrown;
        e.Cancel = true;
    }
    else
    {
        Login1.InstructionText = String.Empty;
    }
}

void OnLoginError(object sender, EventArgs e)
{
    Login1.HelpPageText = "Help with logging in...";
    Login1.PasswordRecoveryText = "Forgot your password?";
}
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="form1" runat="server">
            <asp:Login id="Login1" runat="server" 
                BorderStyle="Solid" 
                BackColor="#F7F7DE" 
                BorderWidth="1px"
                BorderColor="#CCCC99" 
                Font-Size="10pt" 
                Font-Names="Verdana" 
                CreateUserText="Create a new user..."
                CreateUserUrl="newUser.aspx" 
                HelpPageUrl="help.aspx"
                PasswordRecoveryUrl="getPass.aspx" 
                UserNameLabelText="Email address:" 
                OnLoggingIn="OnLoggingIn"
                OnLoginError="OnLoginError" >
                <TitleTextStyle Font-Bold="True" 
                    ForeColor="#FFFFFF" 
                    BackColor="#6B696B">
                </TitleTextStyle>
            </asp:Login>

        </form>
    </body>
</html>
<%@ Page Language="VB" %>
<%@ Import Namespace="System.ComponentModel" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
Function IsValidEmail(ByVal strIn As String) As Boolean
    ' Return true if strIn is in valid email format.
    Return Regex.IsMatch(strIn, ("^([\w-\.]+)@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.)|(([\w-]+\.)+))([a-zA-Z]{2,4}|[0-9]{1,3})(\]?)$"))
End Function

Sub OnLoggingIn(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.LoginCancelEventArgs)
    If Not IsValidEmail(Login1.UserName) Then
        Login1.InstructionText = "Enter a valid email address."
        Login1.InstructionTextStyle.ForeColor = System.Drawing.Color.RosyBrown
        e.Cancel = True
    Else
        Login1.InstructionText = String.Empty
    End If
End Sub

Sub OnLoginError(ByVal sender As Object, ByVal e As EventArgs)
    Login1.HelpPageText = "Help with logging in..."
    Login1.PasswordRecoveryText = "Forgot your password?"
End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="form1" runat="server">
            <asp:Login id="Login1" runat="server" 
                BorderStyle="Solid" 
                BackColor="#F7F7DE" 
                BorderWidth="1px"
                BorderColor="#CCCC99" 
                Font-Size="10pt" 
                Font-Names="Verdana" 
                CreateUserText="Create a new user..."
                CreateUserUrl="newUser.aspx" 
                HelpPageUrl="help.aspx"
                PasswordRecoveryUrl="getPass.aspx" 
                UserNameLabelText="Email address:" 
                OnLoggingIn="OnLoggingIn"
                OnLoginError="OnLoginError" >
                <TitleTextStyle Font-Bold="True" 
                    ForeColor="#FFFFFF" 
                    BackColor="#6B696B">
                </TitleTextStyle>
            </asp:Login>

        </form>
    </body>
</html>

Im folgenden Codebeispiel wird veranschaulicht, wie Sie das Login -Steuerelement erweitern können.The following code example demonstrates how you can extend the Login control. Das CustomLogin Steuerelement enthält DropDownList ein Steuerelement, mit dem Benutzer auswählen können, mit welchem Mitgliedschafts Anbieter Sie authentifiziert werden.The CustomLogin control includes a DropDownList control that lets users choose which membership provider they are authenticated with. (Diese Anbieter sind in der Datei Web. config konfiguriert.) In der OnLoggingIn -Methode wird MembershipProvider die-Eigenschaft auf DropDownList den ausgewählten Wert des-Steuer Elements festgelegt.(These providers are configured in Web.config.) In the OnLoggingIn method, the MembershipProvider property is set to the selected value of the DropDownList control.

Wichtig

Dieses Beispiel enthält ein Textfeld, das Benutzereingaben akzeptiert. Dies ist eine potenzielle Sicherheitsbedrohung.This example contains a text box that accepts user input, which is a potential security threat. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.For more information, see Script Exploits Overview.

using System;
using System.Data;
using System.Configuration;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;

namespace Samples.AspNet.Controls
{
    public sealed class CustomLogin : Login
    {
        public CustomLogin() { }
        
        protected override void OnLoggingIn(LoginCancelEventArgs e)
        {
            // Set the Membership provider for the Login control from a DropDownList.
            DropDownList list = (DropDownList)this.FindControl("domain");
            this.MembershipProvider = list.SelectedValue;
            base.OnLoggingIn(e);
        }
        
        protected override void CreateChildControls()
        {
            LayoutTemplate = new MyTemplate();
            base.CreateChildControls();
        }
    }
    
    // A Template that contains the child controls.
    public class MyTemplate : ITemplate
    {
        void ITemplate.InstantiateIn(Control container)
        {
            // A TextBox for the user name.
            TextBox username = new TextBox();
            username.ID = "username";
            
            // A TextBox for the password.
            TextBox password = new TextBox();
            password.ID = "password";
            
            // A CheckBox to remember the user on subsequent visits.
            CheckBox remember = new CheckBox();
            remember.ID = "RememberMe";
            remember.Text = "Don't forget me!";
            
            // Failure Text.
            Literal failure = new Literal();
            failure.ID = "FailureText";
            
            // A DropDownList to choose the Membership provider.
            DropDownList domain = new DropDownList();
            domain.ID = "Domain";
            domain.Items.Add(new ListItem("SqlMembers"));
            domain.Items.Add(new ListItem("SqlMembers2"));
            
            // A Button to log in.
            Button submit = new Button();
            submit.CommandName = "login";
            submit.Text = "LOGIN";

            container.Controls.Add(new LiteralControl("UserName:"));
            container.Controls.Add(username);
            container.Controls.Add(new LiteralControl("<br>Password:"));
            container.Controls.Add(password);
            container.Controls.Add(new LiteralControl("<br>"));
            container.Controls.Add(remember);
            container.Controls.Add(new LiteralControl("<br>Domain:"));
            container.Controls.Add(domain);
            container.Controls.Add(new LiteralControl("<br>"));
            container.Controls.Add(failure);
            container.Controls.Add(new LiteralControl("<br>"));
            container.Controls.Add(submit);
        }
    }    
}
Imports System.Data
Imports System.Configuration
Imports System.Web
Imports System.Web.Security
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts
Imports System.Web.UI.HtmlControls

Namespace Samples.AspNet.Controls

    NotInheritable Public Class CustomLogin
        Inherits Login

        Public Sub New() 
        End Sub 'New

        Protected Overrides Sub OnLoggingIn(ByVal e As LoginCancelEventArgs) 

            ' Set the Membership provider for the Login control from a DropDownList.
            Dim list As DropDownList = CType(Me.FindControl("domain"), DropDownList)
            Me.MembershipProvider = list.SelectedValue
            MyBase.OnLoggingIn(e)

        End Sub 'OnLoggingIn


        Protected Overrides Sub CreateChildControls() 

            LayoutTemplate = New MyTemplate()
            MyBase.CreateChildControls()

        End Sub 'CreateChildControls
    End Class 'CustomLogin

    ' A Template that contains the child controls.
    Public Class MyTemplate
        Implements ITemplate

        Sub InstantiateIn(ByVal container As Control)  Implements ITemplate.InstantiateIn
            ' A TextBox for the user name.
            Dim username As New TextBox()
            username.ID = "username"

            ' A TextBox for the password.
            Dim password As New TextBox()
            password.ID = "password"

            ' A CheckBox to remember the user on subsequent visits.
            Dim remember As New CheckBox()
            remember.ID = "RememberMe"
            remember.Text = "Don't forget me!"

            ' Failure Text.
            Dim failure As New Literal()
            failure.ID = "FailureText"

            ' A DropDownList to choose the Membership provider.
            Dim domain As New DropDownList()
            domain.ID = "Domain"
            domain.Items.Add(New ListItem("SqlMembers"))
            domain.Items.Add(New ListItem("SqlMembers2"))

            ' A Button to log in.
            Dim submit As New Button()
            submit.CommandName = "login"
            submit.Text = "LOGIN"

            container.Controls.Add(New LiteralControl("UserName:"))
            container.Controls.Add(username)
            container.Controls.Add(New LiteralControl("<br>Password:"))
            container.Controls.Add(password)
            container.Controls.Add(New LiteralControl("<br>"))
            container.Controls.Add(remember)
            container.Controls.Add(New LiteralControl("<br>Domain:"))
            container.Controls.Add(domain)
            container.Controls.Add(New LiteralControl("<br>"))
            container.Controls.Add(failure)
            container.Controls.Add(New LiteralControl("<br>"))
            container.Controls.Add(submit)

        End Sub 'ITemplate.InstantiateIn
    End Class 'MyTemplate
End Namespace

Hinweise

In diesem Thema:In this topic:

EinführungIntroduction

Das Login -Steuerelement ist ein zusammengesetztes Steuerelement, das alle allgemeinen Benutzeroberflächen Elemente bereitstellt, die zum Authentifizieren eines Benutzers auf einer Website benötigt werden.The Login control is a composite control that provides all the common UI elements needed to authenticate a user on a Web site. Die folgenden drei Elemente sind für alle Anmelde Szenarios erforderlich:The following three elements are required for all login scenarios:

  • Ein eindeutiger Benutzername, um den Benutzer zu identifizieren.A unique user name to identify the user.

  • Ein Kennwort zum Überprüfen der Identität des Benutzers.A password to verify the identity of the user.

  • Eine Anmelde Schaltfläche, um die Anmelde Informationen an den Server zu senden.A login button to send the login information to the server.

Das Login -Steuerelement stellt außerdem die folgenden optionalen Benutzeroberflächen Elemente bereit, die zusätzliche Funktionen unterstützen:The Login control also provides the following optional UI elements that support additional functions:

  • Ein Link für eine Kenn Wort Erinnerung.A link for a password reminder.

  • Ein Kontrollkästchen zum Speichern der Anmelde Informationen zwischen Sitzungen.A Remember Me checkbox for retaining the login information between sessions.

  • Ein Hilfelink für Benutzer, die Probleme bei der Anmeldung haben.A Help link for users who are having trouble logging in.

  • Ein Link zum Registrieren eines neuen Benutzers, der Benutzer zu einer Registrierungsseite umleitet.A Register New User link that redirects users to a registration page.

  • Der Anweisungs Text, der im Anmeldeformular angezeigt wird.Instruction text that appears on the login form.

  • Benutzerdefinierter Fehlertext, der angezeigt wird, wenn der Benutzer auf die Anmelde Schaltfläche klickt, ohne die Felder Benutzername oder Kennwort auszufüllen.Custom error text that appears when the user clicks the login button without filling in the user name or password fields.

  • Benutzerdefinierter Fehlertext, der angezeigt wird, wenn die Anmeldung fehlschlägt.Custom error text that appears if the login fails.

  • Eine benutzerdefinierte Aktion, die auftritt, wenn die Anmeldung erfolgreich ist.A custom action that occurs when login succeeds.

  • Eine Möglichkeit, das Anmelde Steuerelement auszublenden, wenn der Benutzer bereits an der Website angemeldet ist.A way to hide the login control if the user is already logged in to the site.

Eine Tabelle, die anzeigt, welche Steuerelemente erforderlich und welche optional sind LayoutTemplate , finden Sie unter Property.For a table showing which controls are required and which are optional, see LayoutTemplate property.

Hinweis

Wenn Sie mit den in ASP.NET verfügbaren Anmelde Steuerelementen nicht vertraut sind, lesen Sie die Übersicht über ASP.net-Anmelde Steuerelemente , bevor Sie fortfahren.If you are not familiar with the set of login controls available in ASP.NET, see ASP.NET Login Controls Overview before continuing. Eine Liste mit anderen Themen im Zusammenhang mit Anmelde Steuerelementen und Mitgliedschaft finden Sie unter Verwalten von Benutzern mithilfe der Mitgliedschaft.For a list of other topics related to login controls and membership, see Managing Users by Using Membership.

Wichtig

Das akzeptieren von Benutzereingaben ist eine potenzielle Sicherheitsbedrohung.Accepting user input is a potential security threat. Böswillige Benutzer können Daten senden, die zur Offenlegung von Schwachstellen oder zum Ausführen von Programmen mit generierten Kenn Wörtern dienen.Malicious users can send data that is intended to expose vulnerabilities or run programs that try generated passwords. Um die Sicherheit bei der Arbeit mit Benutzereingaben zu verbessern, sollten Sie die Validierungs Features Ihres Steuer Elements verwenden und alle für das Steuerelement konfigurierten Datenanbieter sichern.To improve security when working with user input, you should use the validation features of your control and secure any data providers that are configured for your control. Weitere Informationen finden Sie unter Sichern von Anmelde Steuerelementen, grundlegende Sicherheitsmethoden für Webanwendungenund Sichern der Mitgliedschaft.For more information, see Securing Login Controls, Basic Security Practices for Web Applications, and Securing Membership.

Das Login -Steuerelement verwendet einen Mitgliedschafts Anbieter zum Abrufen von Benutzer Anmelde Informationen.The Login control uses a membership provider to obtain user credentials. Sofern nicht anders angegeben, verwendet Login das Steuerelement den in der Datei "Web. config" definierten Standard Mitgliedschafts Anbieter.Unless you specify otherwise, the Login control uses the default membership provider defined in the Web.config file. Um einen anderen Anbieter anzugeben, legen Sie MembershipProvider die-Eigenschaft auf einen der Namen der Mitgliedschafts Anbieter fest, der in der Datei "Web. config" der Anwendung definiert ist.To specify a different provider, set the MembershipProvider property to one of the membership provider names defined in your application's Web.config file. Weitere Informationen finden Sie unter Mitgliedschafts Anbieter.For more information, see Membership Providers.

Wenn Sie einen benutzerdefinierten Authentifizierungsdienst verwenden möchten, können Sie die- OnAuthenticate Methode verwenden, um den Dienst aufzurufen.If you want to use a custom authentication service, you can use the OnAuthenticate method to call the service.

Stile und VorlagenStyles and Templates

Die Darstellung des Login Steuer Elements ist durch Vorlagen und Stileinstellungen vollständig anpassbar.The appearance of the Login control is fully customizable through templates and style settings. Alle Benutzeroberflächen-Textnachrichten können auch über die Login Eigenschaften der-Klasse angepasst werden.All UI text messages are also customizable through properties of the Login class. Der Standardschnittstellen Text wird automatisch basierend auf der Gebiets Schema Einstellung auf dem Server lokalisiert.The default interface text is automatically localized based on the locale setting on the server.

Wenn das Login Steuerelement mit Vorlagen angepasst wird, werden AccessKey die-Eigenschaft TabIndex und die-Eigenschaft ignoriert.If the Login control is customized with templates, then the AccessKey property and the TabIndex property are ignored. Legen Sie in diesem Fall die AccessKey -Eigenschaft und TabIndex die-Eigenschaft der einzelnen Vorlagen untergeordneten Steuerelemente direkt fest.In this case, set the AccessKey property and the TabIndex property of each template child control directly.

LoginSteuerelement Eigenschaften, die durch Textfelder ( UserName z Password. b. und) dargestellt werden, sind in allen Phasen des Lebenszyklus der Seite verfügbar.Login control properties represented by text boxes, such as UserName and Password, are accessible during all phases of the page life cycle. Das-Steuerelement übernimmt alle vom Endbenutzer vorgenommenen Änderungen mithilfe des TextChanged Ereignisses, das von den Textfeldern ausgelöst wird.The control will pick up any changes made by the end user by means of the TextChanged event triggered by the textboxes.

Hinweis

Wenn Sie Login das-Steuerelement in WizardStep ein-Objekt einbetten ActiveStepIndex , legen Sie Page_Load die-Eigenschaft in einem-Ereignishandler explizit fest, wenn der Benutzer authentifiziert ist.If you embed the Login control in a WizardStep object, explicitly set the ActiveStepIndex property in a Page_Load event handler if the user is authenticated. Das Wizard -Steuerelement wird nicht automatisch mit dem WizardStep nächsten-Objekt in diesem Szenario fortfahren.The Wizard control does not automatically advance to the next WizardStep object in this scenario.

In der folgenden Tabelle werden Login die Eigenschaften des Steuerelement Stils aufgelistet und erläutert, auf welches Benutzeroberflächen Element sich jede Format Eigenschaft auswirktThe following table lists the Login control style properties and explains which UI element each style property affects. Eine Liste der Eigenschaften, für die die einzelnen Stile gelten, finden Sie in der Dokumentation zu den einzelnen Stileigenschaften.For a list of which properties each style applies to, see the documentation for the individual style properties.

Style-EigenschaftStyle property Betroffenes Benutzeroberflächen ElementUI element affected
BorderPadding Der Leerraum zwischen dem Steuerelement Inhalt und dem Rahmen des Steuer Elements.The space between the control contents and the control's border.
CheckBoxStyle Kontrollkästchen Speichern.Remember Me checkbox.
FailureTextStyle Anmeldefehler Text.Login failure text.
InstructionTextStyle Der Anweisungs Text auf der Seite, der Benutzern mitteilt, wie das-Steuerelement verwendet werden soll.Instructional text on the page that tells users how to use the control.
LabelStyle Bezeichnungen für alle Eingabefelder, z. b. Textfelder.Labels for all input fields, such as text boxes.
TextBoxStyle Eingabefelder für Text Eingabe.Text entry input fields.
TitleTextStyle Titeltext.Title text.
ValidatorTextStyle Text, der dem Benutzer angezeigt wird, wenn ein Anmeldeversuch aufgrund von Validierungs Fehlern nicht erfolgreich ist.Text displayed to the user when a login attempt is unsuccessful due to validation errors.
HyperLinkStyle Links zu anderen Seiten.Links to other pages.
LoginButtonStyle Anmelde Schaltfläche.Login button.

Validierungs GruppierungenValidation Groupings

Der UserName - Password Eigenschaft und RequiredFieldValidator der-Eigenschaft sind Steuerelemente zugeordnet, um zu verhindern, dass Benutzer die Seite übermitteln, ohne erforderliche Informationen bereitzustellenThe UserName and Password properties have RequiredFieldValidator controls associated with them to prevent users from submitting the page without providing required information.

Das Login -Steuerelement verwendet eine Validierungs Gruppe, sodass andere Felder auf derselben Seite wie Login das Steuerelement separat überprüft werden können.The Login control uses a validation group so that other fields on the same page as the Login control can be validated separately. Standardmäßig wird die ID -Eigenschaft Login des-Steuer Elements als Name der Validierungs Gruppe verwendet.By default, the ID property of the Login control is used as the name of the validation group. Ein Login Steuerelement mit der ID "Login1" verwendet beispielsweise den Validierungs Gruppennamen "Login1".For example, a Login control with the ID "Login1" will use a validation group name of "Login1". Wenn Sie die Validierungs Gruppe festlegen möchten, zu der Login das Steuerelement gehört, müssen Sie die Vorlage für das Steuerelement erstellen und den Namen der Validierungs Gruppe ändern.If you want to set the validation group that the Login control is part of, you must template the control and change the validation group name.

Anwenden von CSS-StilenApplying CSS Styles

Mit Login dem-Steuerelement können Sie CSS-Stilregeln im Markup angeben.The Login control lets you specify CSS style rules in markup. Wenn Sie Vorlagen verwenden, um die Darstellung des Login Steuer Elements anzupassen, können Sie CSS-Stile im Markup in den Vorlagen angeben.If you use templates to customize the appearance of the Login control, you can specify CSS styles in the markup in the templates. In diesem Fall ist keine zusätzliche äußere Tabelle erforderlich.In that case, no extra outer table is required. Sie können verhindern, dass die Tabelle gerendert wird RenderOuterTable , indem falseSie die-Eigenschaft auf festlegen.You can prevent the table from being rendered by setting the RenderOuterTable property to false.

ZugriffAccessibility

Weitere Informationen zur Verwendung dieses Steuerelement so konfigurieren, dass sie Markup generiert, das Accessibility Standards entspricht, finden Sie unter Barrierefreiheit in Visual Studio und ASP.NET und ASP.NET-Steuerelemente und Barrierefreiheit.For information about how to configure this control so that it generates markup that conforms to accessibility standards, see Accessibility in Visual Studio and ASP.NET and ASP.NET Controls and Accessibility.

Deklarative SyntaxDeclarative Syntax

<asp:Login  
    AccessKey="string"  
    BackColor="color name|#dddddd"  
    BorderColor="color name|#dddddd"  
    BorderPadding="integer"  
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|  
        Inset|Outset"  
    BorderWidth="size"  
    CreateUserIconUrl="uri"  
    CreateUserText="string"  
    CreateUserUrl="uri"  
    CssClass="string"  
    DestinationPageUrl="uri"  
    DisplayRememberMe="True|False"  
    Enabled="True|False"  
    EnableTheming="True|False"  
    EnableViewState="True|False"  
    FailureAction="Refresh|RedirectToLoginPage"  
    FailureText="string"  
    Font-Bold="True|False"  
    Font-Italic="True|False"  
    Font-Names="string"  
    Font-Overline="True|False"  
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|  
               Large|X-Large|XX-Large"  
    Font-Strikeout="True|False"  
    Font-Underline="True|False"  
    ForeColor="color name|#dddddd"  
    Height="size"  
    HelpPageIconUrl="uri"  
    HelpPageText="string"  
    HelpPageUrl="uri"  
    ID="string"  
    InstructionText="string"  
    LoginButtonImageUrl="uri"  
    LoginButtonText="string"  
    LoginButtonType="Button|Image|Link"  
    MembershipProvider="string"  
    OnAuthenticate="Authenticate event handler"  
    OnDataBinding="DataBinding event handler"  
    OnDisposed="Disposed event handler"  
    OnInit="Init event handler"  
    OnLoad="Load event handler"  
    OnLoggedIn="LoggedIn event handler"  
    OnLoggingIn="LoggingIn event handler"  
    OnLoginError="LoginError event handler"  
    OnPreRender="PreRender event handler"  
    OnUnload="Unload event handler"  
    Orientation="Horizontal|Vertical"  
    PasswordLabelText="string"  
    PasswordRecoveryIconUrl="uri"  
    PasswordRecoveryText="string"  
    PasswordRecoveryUrl="uri"  
    PasswordRequiredErrorMessage="string"  
    RememberMeSet="True|False"  
    RememberMeText="string"  
    runat="server"  
    SkinID="string"  
    Style="string"  
    TabIndex="integer"  
    TextLayout="TextOnLeft|TextOnTop"  
    TitleText="string"  
    ToolTip="string"  
    UserName="string"  
    UserNameLabelText="string"  
    UserNameRequiredErrorMessage="string"  
    Visible="True|False"  
    VisibleWhenLoggedIn="True|False"  
    Width="size"  
>  
        <CheckBoxStyle />  
        <FailureTextStyle />  
        <HyperLinkStyle />  
        <InstructionTextStyle />  
        <LabelStyle />  
        <LayoutTemplate>  
            <!-- child controls -->  
        </LayoutTemplate>  
        <LoginButtonStyle />  
        <TextBoxStyle />  
        <TitleTextStyle />  
        <ValidatorTextStyle />  
</asp:Login>  

Konstruktoren

Login() Login() Login() Login()

Erstellt eine neue Instanz des Login-Steuerelements.Creates a new instance of the Login control.

Felder

LoginButtonCommandName LoginButtonCommandName LoginButtonCommandName LoginButtonCommandName

Stellt den der Anmeldeschaltfläche zugeordneten Befehlsnamen dar.Represents the command name associated with the login button.

Eigenschaften

AccessKey AccessKey AccessKey AccessKey

Ruft die Zugriffstaste ab, mit der Sie schnell zum Webserversteuerelement navigieren können, oder legt diese fest.Gets or sets the access key that allows you to quickly navigate to the Web server control.

(Inherited from WebControl)
Adapter Adapter Adapter Adapter

Ruft den browserspezifischen Adapter für das Steuerelement ab.Gets the browser-specific adapter for the control.

(Inherited from Control)
AppRelativeTemplateSourceDirectory AppRelativeTemplateSourceDirectory AppRelativeTemplateSourceDirectory AppRelativeTemplateSourceDirectory

Ruft das anwendungsrelative virtuelle Verzeichnis des Page-Objekts oder des UserControl-Objekt ab, das dieses Steuerelement enthält, oder legt dieses Verzeichnis fest.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(Inherited from Control)
Attributes Attributes Attributes Attributes

Ruft die Auflistung von beliebigen Attributen (nur für die Darstellung) ab, die keinen Eigenschaften des Steuerelements entsprechen.Gets the collection of arbitrary attributes (for rendering only) that do not correspond to properties on the control.

(Inherited from WebControl)
BackColor BackColor BackColor BackColor

Ruft die Hintergrundfarbe des Webserversteuerelements ab oder legt diese fest.Gets or sets the background color of the Web server control.

(Inherited from WebControl)
BindingContainer BindingContainer BindingContainer BindingContainer

Ruft das Steuerelement ab, das die Datenbindung dieses Steuerelements enthält.Gets the control that contains this control's data binding.

(Inherited from Control)
BorderColor BorderColor BorderColor BorderColor

Ruft die Rahmenfarbe des Websteuerelements ab oder legt diese fest.Gets or sets the border color of the Web control.

(Inherited from WebControl)
BorderPadding BorderPadding BorderPadding BorderPadding

Ruft den Zwischenraum innerhalb der Rahmen des Login-Steuerelements ab oder legt diesen fest.Gets or sets the amount of padding inside the borders of the Login control.

BorderStyle BorderStyle BorderStyle BorderStyle

Ruft die Rahmenart des Webserversteuerelements ab oder legt diese fest.Gets or sets the border style of the Web server control.

(Inherited from WebControl)
BorderWidth BorderWidth BorderWidth BorderWidth

Ruft die Rahmenbreite des Webserversteuerelements ab oder legt diese fest.Gets or sets the border width of the Web server control.

(Inherited from WebControl)
CheckBoxStyle CheckBoxStyle CheckBoxStyle CheckBoxStyle

Ruft einen Verweis auf ein Style-Objekt ab, das die Einstellungen für das Kontrollkästchen für die Speicherung der Anmeldedaten definiert.Gets a reference to a Style object that defines the settings for the Remember Me check box.

ChildControlsCreated ChildControlsCreated ChildControlsCreated ChildControlsCreated

Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des Serversteuerelements erstellt wurden.Gets a value that indicates whether the server control's child controls have been created.

(Inherited from Control)
ClientID ClientID ClientID ClientID

Ruft die Steuerelement-ID für HTML-Markup ab, das von ASP.NET generiert wird.Gets the control ID for HTML markup that is generated by ASP.NET.

(Inherited from Control)
ClientIDMode ClientIDMode ClientIDMode ClientIDMode

Ruft den Algorithmus ab, mit dem der Wert der ClientID-Eigenschaft generiert wird, oder legt diesen fest.Gets or sets the algorithm that is used to generate the value of the ClientID property.

(Inherited from Control)
ClientIDSeparator ClientIDSeparator ClientIDSeparator ClientIDSeparator

Ruft einen Zeichenwert ab, der das in der ClientID-Eigenschaft verwendete Trennzeichen darstellt.Gets a character value representing the separator character used in the ClientID property.

(Inherited from Control)
Context Context Context Context

Ruft das dem Serversteuerelement für die aktuelle Webanforderung zugeordnete HttpContext-Objekt ab.Gets the HttpContext object associated with the server control for the current Web request.

(Inherited from Control)
Controls Controls Controls Controls

Ruft ein ControlCollection-Objekt ab, das die untergeordneten Steuerelemente in einem CompositeControl darstellt.Gets a ControlCollection object that represents the child controls in a CompositeControl.

(Inherited from CompositeControl)
ControlStyle ControlStyle ControlStyle ControlStyle

Ruft den Stil des Webserversteuerelements ab.Gets the style of the Web server control. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet.This property is used primarily by control developers.

(Inherited from WebControl)
ControlStyleCreated ControlStyleCreated ControlStyleCreated ControlStyleCreated

Ruft einen Wert ab, der angibt, ob ein Style-Objekt für die ControlStyle-Eigenschaft erstellt wurde.Gets a value indicating whether a Style object has been created for the ControlStyle property. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet.This property is primarily used by control developers.

(Inherited from WebControl)
CreateUserIconUrl CreateUserIconUrl CreateUserIconUrl CreateUserIconUrl

Ruft den Speicherort eines Bilds ab, das neben dem Link zu einer Registrierungsseite für neue Benutzer angezeigt wird.Gets the location of an image to display next to the link to a registration page for new users.

CreateUserText CreateUserText CreateUserText CreateUserText

Ruft den Text eines Links zu einer Registrierungsseite für neue Benutzer ab oder legt diesen fest.Gets or sets the text of a link to a registration page for new users.

CreateUserUrl CreateUserUrl CreateUserUrl CreateUserUrl

Ruft die URL der Registrierungsseite für neue Benutzer ab oder legt diese fest.Gets or sets the URL of the new-user registration page.

CssClass CssClass CssClass CssClass

Ruft die vom Webserversteuerelement auf dem Client gerenderte CSS-Klasse (Cascading Style Sheet) ab oder legt diese fest.Gets or sets the Cascading Style Sheet (CSS) class rendered by the Web server control on the client.

(Inherited from WebControl)
DataItemContainer DataItemContainer DataItemContainer DataItemContainer

Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataItemContainer implementiert wird.Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Inherited from Control)
DataKeysContainer DataKeysContainer DataKeysContainer DataKeysContainer

Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataKeysControl implementiert wird.Gets a reference to the naming container if the naming container implements IDataKeysControl.

(Inherited from Control)
DesignMode DesignMode DesignMode DesignMode

Ruft einen Wert ab, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird.Gets a value indicating whether a control is being used on a design surface.

(Inherited from Control)
DestinationPageUrl DestinationPageUrl DestinationPageUrl DestinationPageUrl

Ruft die URL der Seite ab, die dem Benutzer nach erfolgreicher Anmeldung angezeigt wird, oder legt diesen fest.Gets or sets the URL of the page displayed to the user when a login attempt is successful.

DisplayRememberMe DisplayRememberMe DisplayRememberMe DisplayRememberMe

Ruft einen Wert ab, der angibt, ob ein Kontrollkästchen angezeigt werden soll, damit der Benutzer steuern kann, ob ein persistentes Cookie an den Browser gesendet wird.Gets or sets a value indicating whether to display a check box to enable the user to control whether a persistent cookie is sent to their browser.

Enabled Enabled Enabled Enabled

Ruft einen Wert ab, der angibt, ob das Webserversteuerelement aktiviert ist, oder legt diesen fest.Gets or sets a value indicating whether the Web server control is enabled.

(Inherited from WebControl)
EnableTheming EnableTheming EnableTheming EnableTheming

Ruft einen Wert ab, der angibt, ob für dieses Steuerelement Designs gelten, oder legt diesen fest.Gets or sets a value indicating whether themes apply to this control.

(Inherited from WebControl)
EnableViewState EnableViewState EnableViewState EnableViewState

Ruft einen Wert ab, der dem anfordernden Client angibt, ob das Serversteuerelement seinen Ansichtszustand sowie den Ansichtszustand von jedem enthaltenen untergeordneten Steuerelement beibehält, oder legt diesen fest.Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

(Inherited from Control)
Events Events Events Events

Ruft eine Liste von Ereignishandlerdelegaten für das Steuerelement ab.Gets a list of event handler delegates for the control. Diese Eigenschaft ist schreibgeschützt.This property is read-only.

(Inherited from Control)
FailureAction FailureAction FailureAction FailureAction

Ruft die Aktion ab, die nach einer fehlgeschlagenen Anmeldung eintritt, oder legt diese fest.Gets or sets the action that occurs when a login attempt fails.

FailureText FailureText FailureText FailureText

Ruft den Text ab, der angezeigt wird, wenn ein Anmeldeversuch fehlschlägt, oder legt diesen fest.Gets or sets the text displayed when a login attempt fails.

FailureTextStyle FailureTextStyle FailureTextStyle FailureTextStyle

Ruft einen Verweis auf eine Auflistung von Eigenschaften ab, die die Darstellung des Fehlertexts im Login-Steuerelement definieren.Gets a reference to a collection of properties that define the appearance of error text in the Login control.

Font Font Font Font

Ruft die Schriftarteigenschaften ab, die dem Webserversteuerelement zugeordnet sind.Gets the font properties associated with the Web server control.

(Inherited from WebControl)
ForeColor ForeColor ForeColor ForeColor

Ruft die Vordergrundfarbe (i. A. die Textfarbe) für das Webserversteuerelement ab oder legt diese fest.Gets or sets the foreground color (typically the color of the text) of the Web server control.

(Inherited from WebControl)
HasAttributes HasAttributes HasAttributes HasAttributes

Ruft einen Wert ab, der angibt, ob für das Steuerelement Attribute festgelegt wurden.Gets a value indicating whether the control has attributes set.

(Inherited from WebControl)
HasChildViewState HasChildViewState HasChildViewState HasChildViewState

Ruft einen Wert ab, der angibt, ob in den untergeordneten Steuerelementen des aktuellen Serversteuerelements gespeicherte Einstellungen für den Ansichtszustand vorhanden sind.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Inherited from Control)
Height Height Height Height

Ruft die Höhe des Webserversteuerelements ab oder legt diese fest.Gets or sets the height of the Web server control.

(Inherited from WebControl)
HelpPageIconUrl HelpPageIconUrl HelpPageIconUrl HelpPageIconUrl

Ruft den Speicherort eines Bildes ab, um dieses neben dem Link der Login-Hilfeseite anzuzeigenGets the location of an image to display next to the link to the login Help page.

HelpPageText HelpPageText HelpPageText HelpPageText

Ruft den Text eines Links zur Hilfeseite für die Anmeldung ab oder legt diesen fest.Gets or sets the text of a link to the login Help page.

HelpPageUrl HelpPageUrl HelpPageUrl HelpPageUrl

Ruft die URL der Hilfeseite für die Anmeldung ab oder legt diese fest.Gets or sets the URL of the login Help page.

HyperLinkStyle HyperLinkStyle HyperLinkStyle HyperLinkStyle

Ruft einen Verweis auf eine Auflistung von Eigenschaften ab, die die Darstellung von Links im Login-Steuerelement definieren.Gets a reference to a collection of properties that define the appearance of hyperlinks in the Login control.

IControlBuilderAccessor.ControlBuilder IControlBuilderAccessor.ControlBuilder IControlBuilderAccessor.ControlBuilder IControlBuilderAccessor.ControlBuilder

Eine Beschreibung dieses Elements finden Sie unter ControlBuilder.For a description of this member, see ControlBuilder.

(Inherited from Control)
IControlDesignerAccessor.UserData IControlDesignerAccessor.UserData IControlDesignerAccessor.UserData IControlDesignerAccessor.UserData

Eine Beschreibung dieses Elements finden Sie unter UserData.For a description of this member, see UserData.

(Inherited from Control)
ID ID ID ID

Ruft den programmgesteuerten Bezeichner ab, der dem Serversteuerelement zugewiesen ist, oder legt diesen fest.Gets or sets the programmatic identifier assigned to the server control.

(Inherited from Control)
IDataBindingsAccessor.DataBindings IDataBindingsAccessor.DataBindings IDataBindingsAccessor.DataBindings IDataBindingsAccessor.DataBindings

Eine Beschreibung dieses Elements finden Sie unter DataBindings.For a description of this member, see DataBindings.

(Inherited from Control)
IDataBindingsAccessor.HasDataBindings IDataBindingsAccessor.HasDataBindings IDataBindingsAccessor.HasDataBindings IDataBindingsAccessor.HasDataBindings

Eine Beschreibung dieses Elements finden Sie unter HasDataBindings.For a description of this member, see HasDataBindings.

(Inherited from Control)
IdSeparator IdSeparator IdSeparator IdSeparator

Ruft das als Trennzeichen für Steuerelementbezeichner verwendete Zeichen ab.Gets the character used to separate control identifiers.

(Inherited from Control)
IExpressionsAccessor.Expressions IExpressionsAccessor.Expressions IExpressionsAccessor.Expressions IExpressionsAccessor.Expressions

Eine Beschreibung dieses Members finden Sie unter Expressions.For a description of this member, see Expressions.

(Inherited from Control)
IExpressionsAccessor.HasExpressions IExpressionsAccessor.HasExpressions IExpressionsAccessor.HasExpressions IExpressionsAccessor.HasExpressions

Eine Beschreibung dieses Elements finden Sie unter HasExpressions.For a description of this member, see HasExpressions.

(Inherited from Control)
InstructionText InstructionText InstructionText InstructionText

Ruft den Anweisungstext für Benutzeranmeldungen ab oder legt diesen fest.Gets or sets login instruction text for the user.

InstructionTextStyle InstructionTextStyle InstructionTextStyle InstructionTextStyle

Ruft einen Verweis auf ein TableItemStyle-Objekt ab, das die Einstellungen für den Anweisungstext im Login-Steuerelement definiert.Gets a reference to a TableItemStyle object that defines the settings for instruction text in the Login control.

IsChildControlStateCleared IsChildControlStateCleared IsChildControlStateCleared IsChildControlStateCleared

Ruft einen Wert ab, der angibt, ob in diesem Steuerelements enthaltene Steuerelemente über einen Steuerelementzustand verfügen.Gets a value indicating whether controls contained within this control have control state.

(Inherited from Control)
IsEnabled IsEnabled IsEnabled IsEnabled

Ruft einen Wert ab, der angibt, ob das Steuerelement aktiviert ist.Gets a value indicating whether the control is enabled.

(Inherited from WebControl)
IsTrackingViewState IsTrackingViewState IsTrackingViewState IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das Serversteuerelement Änderungen des Ansichtszustands speichert.Gets a value that indicates whether the server control is saving changes to its view state.

(Inherited from Control)
IsViewStateEnabled IsViewStateEnabled IsViewStateEnabled IsViewStateEnabled

Ruft einen Wert ab, der angibt, ob der Ansichtszustand für dieses Steuerelement aktiviert ist.Gets a value indicating whether view state is enabled for this control.

(Inherited from Control)
LabelStyle LabelStyle LabelStyle LabelStyle

Ruft einen Verweis auf ein TableItemStyle-Objekt ab, das die Einstellungen für die Bezeichnungen von Login-Objekten definiert.Gets a reference to a TableItemStyle object that defines the settings for Login control labels.

LayoutTemplate LayoutTemplate LayoutTemplate LayoutTemplate

Ruft die zum Anzeigen des Login-Steuerelements verwendete Vorlage ab oder legt diese fest.Gets or sets the template used to display the Login control.

LoadViewStateByID LoadViewStateByID LoadViewStateByID LoadViewStateByID

Ruft einen Wert ab, der angibt, ob das Steuerelement seinen Ansichtszustand über ID anstatt über den Index lädt.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(Inherited from Control)
LoginButtonImageUrl LoginButtonImageUrl LoginButtonImageUrl LoginButtonImageUrl

Ruft die URL eines Bilds ab, das für die Anmeldeschaltfläche verwendet werden soll, oder legt diese fest.Gets or sets the URL of an image to use for the login button.

LoginButtonStyle LoginButtonStyle LoginButtonStyle LoginButtonStyle

Ruft einen Verweis auf das Style-Objekt ab, mit dem Sie die Darstellung der Anmeldeschaltfläche in einem Login-Steuerelement festlegen können.Gets a reference to the Style object that allows you to set the appearance of the login button in the Login control.

LoginButtonText LoginButtonText LoginButtonText LoginButtonText

Ruft den Text für die Anmeldeschaltfläche des Login-Steuerelements ab oder legt diesen fest.Gets or sets the text for the Login control's login button.

LoginButtonType LoginButtonType LoginButtonType LoginButtonType

Ruft den Typ der Schaltfläche ab, der bei der Darstellung der Login-Schaltfläche verwendet wird, oder legt diesen fest.Gets or sets the type of button to use when rendering the Login button.

MembershipProvider MembershipProvider MembershipProvider MembershipProvider

Ruft den Namen des vom Steuerelement verwendeten Mitgliedschaftsdatenanbieters ab oder legt diesen fest.Gets or sets the name of the membership data provider used by the control.

NamingContainer NamingContainer NamingContainer NamingContainer

Ruft einen Verweis auf den Benennungscontainer des Serversteuerelements ab, der einen eindeutigen Namespace erstellt, damit zwischen Serversteuerelementen mit demselben ID-Eigenschaftswert unterschieden werden kann.Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.

(Inherited from Control)
Orientation Orientation Orientation Orientation

Ruft einen Wert ab, der die Position der Elemente des Login-Steuerelements auf der Seite angibt, oder legt diesen fest.Gets or sets a value that specifies the position of the elements of the Login control on the page.

Page Page Page Page

Ruft einen Verweis auf die Page-Instanz ab, die das Serversteuerelement enthält.Gets a reference to the Page instance that contains the server control.

(Inherited from Control)
Parent Parent Parent Parent

Ruft einen Verweis auf das übergeordnete Steuerelement des Serversteuerelements in der Steuerelementhierarchie der Seite ab.Gets a reference to the server control's parent control in the page control hierarchy.

(Inherited from Control)
Password Password Password Password

Ruft das vom Benutzer eingegebene Kennwort ab.Gets the password entered by the user.

PasswordLabelText PasswordLabelText PasswordLabelText PasswordLabelText

Ruft den Text der Bezeichnung für das Password-Textfeld ab oder legt diesen fest.Gets or sets the text of the label for the Password text box.

PasswordRecoveryIconUrl PasswordRecoveryIconUrl PasswordRecoveryIconUrl PasswordRecoveryIconUrl

Ruft den Speicherort eines Bilds ab, das neben dem Link zur Seite für die Kennwortwiederherstellung angezeigt wird.Gets the location of an image to display next to the link to the password recovery page.

PasswordRecoveryText PasswordRecoveryText PasswordRecoveryText PasswordRecoveryText

Ruft den Text eines Links zur Seite für die Kennwortwiederherstellung ab oder legt diesen fest.Gets or sets the text of a link to the password recovery page.

PasswordRecoveryUrl PasswordRecoveryUrl PasswordRecoveryUrl PasswordRecoveryUrl

Ruft die URL der Seite für die Kennwortwiederherstellung ab oder legt diese fest.Gets or sets the URL of the password recovery page.

PasswordRequiredErrorMessage PasswordRequiredErrorMessage PasswordRequiredErrorMessage PasswordRequiredErrorMessage

Ruft die Fehlermeldung ab, die in einem ValidationSummary-Steuerelement angezeigt wird, wenn das Feld Password leer gelassen wurde.Gets or sets the error message to display in a ValidationSummary control when the password field is left blank.

RememberMeSet RememberMeSet RememberMeSet RememberMeSet

Ruft einen Wert ab, der angibt, ob ein persistentes Authentifizierungscookie an den Browser des Benutzers gesendet wird, oder legt diesen fest.Gets or sets a value indicating whether to send a persistent authentication cookie to the user's browser.

RememberMeText RememberMeText RememberMeText RememberMeText

Ruft den Text der Bezeichnung des Kontrollkästchens für die Speicherung der Anmeldedaten ab oder legt diesen fest.Gets or sets the text of the label for the Remember Me check box.

RenderingCompatibility RenderingCompatibility RenderingCompatibility RenderingCompatibility

Ruft einen Wert ab, der die ASP.NET-Version angibt, mit der gerenderte HTML-Objekte kompatibel sind.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(Inherited from Control)
RenderOuterTable RenderOuterTable RenderOuterTable RenderOuterTable

Ruft einen Wert ab, der angibt, ob das Steuerelement gerendertes HTML in einem table-Element einschließt, um Inlinestile zu übernehmen.Gets or sets a value that indicates whether the control encloses rendered HTML in a table element in order to apply inline styles.

Site Site Site Site

Ruft Informationen zum Container ab, der das aktuelle Steuerelement hostet, wenn es auf einer Entwurfsoberfläche gerendert wird.Gets information about the container that hosts the current control when rendered on a design surface.

(Inherited from Control)
SkinID SkinID SkinID SkinID

Ruft das Design ab, das auf das Steuerelement angewendet werden soll.Gets or sets the skin to apply to the control.

(Inherited from WebControl)
Style Style Style Style

Ruft eine Auflistung der Textattribute ab, die im äußeren Tag des Webserversteuerelements als Formatvorlagenattribut gerendert werden.Gets a collection of text attributes that will be rendered as a style attribute on the outer tag of the Web server control.

(Inherited from WebControl)
SupportsDisabledAttribute SupportsDisabledAttribute SupportsDisabledAttribute SupportsDisabledAttribute

Ruft einen Wert ab, der angibt, ob vom Steuerelement das disabled-Attribut des gerenderten HTML-Elements auf "disabled" festgelegt werden soll, wenn die IsEnabled-Eigenschaft des Steuerelements false ist.Gets a value that indicates whether the control should set the disabled attribute of the rendered HTML element to "disabled" when the control's IsEnabled property is false.

(Inherited from CompositeControl)
TabIndex TabIndex TabIndex TabIndex

Ruft den Index der Aktivierreihenfolge des Webserversteuerelements ab oder legt diesen fest.Gets or sets the tab index of the Web server control.

(Inherited from WebControl)
TagKey TagKey TagKey TagKey

Ruft den HtmlTextWriterTag-Wert ab, der einem Login-Steuerelement entspricht.Gets the HtmlTextWriterTag value that corresponds to a Login control. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet.This property is used primarily by control developers.

TagName TagName TagName TagName

Ruft den Namen des Steuerelementtags ab.Gets the name of the control tag. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet.This property is used primarily by control developers.

(Inherited from WebControl)
TemplateControl TemplateControl TemplateControl TemplateControl

Ruft einen Verweis auf die Vorlage ab, die dieses Steuerelement enthält, oder legt den Verweis fest.Gets or sets a reference to the template that contains this control.

(Inherited from Control)
TemplateSourceDirectory TemplateSourceDirectory TemplateSourceDirectory TemplateSourceDirectory

Ruft das virtuelle Verzeichnis der Page oder des UserControl ab, in dem das aktuelle Serversteuerelement enthalten ist.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Inherited from Control)
TextBoxStyle TextBoxStyle TextBoxStyle TextBoxStyle

Ruft einen Verweis auf eine Auflistung von Eigenschaften ab, die die Darstellung der Textfelder im Login-Steuerelement definieren.Gets a reference to a collection of properties that define the appearance of text boxes in the Login control.

TextLayout TextLayout TextLayout TextLayout

Gibt die Position jeder Bezeichnung relativ zu dem zugeordneten Textfeld für das Login-Steuerelement an.Specifies the position of each label relative to its associated text box for the Login control.

TitleText TitleText TitleText TitleText

Ruft den Titel des Login-Steuerelements ab oder legt diesen fest.Gets or sets the title of the Login control.

TitleTextStyle TitleTextStyle TitleTextStyle TitleTextStyle

Ruft einen Verweis auf eine Auflistung von Eigenschaften ab, die die Darstellung des Titeltexts im Login-Steuerelement definieren.Gets a reference to a collection of properties that define the appearance of the title text in the Login control.

ToolTip ToolTip ToolTip ToolTip

Ruft den Text ab, der angezeigt wird, wenn mit dem Mauszeiger auf das Webserversteuerelement gezeigt wird, oder legt diesen fest.Gets or sets the text displayed when the mouse pointer hovers over the Web server control.

(Inherited from WebControl)
UniqueID UniqueID UniqueID UniqueID

Ruft den eindeutigen, hierarchisierten Bezeichner für das Serversteuerelement ab.Gets the unique, hierarchically qualified identifier for the server control.

(Inherited from Control)
UserName UserName UserName UserName

Ruft den vom Benutzer eingegebenen Benutzernamen ab.Gets the user name entered by the user.

UserNameLabelText UserNameLabelText UserNameLabelText UserNameLabelText

Ruft den Text der Bezeichnung für das UserName-Textfeld ab oder legt diesen fest.Gets or sets the text of the label for the UserName text box.

UserNameRequiredErrorMessage UserNameRequiredErrorMessage UserNameRequiredErrorMessage UserNameRequiredErrorMessage

Ruft die Fehlermeldung ab, die in einem ValidationSummary-Steuerelement angezeigt wird, wenn das Feld für den Benutzernamen leer gelassen wurde.Gets or sets the error message to display in a ValidationSummary control when the user name field is left blank.

ValidateRequestMode ValidateRequestMode ValidateRequestMode ValidateRequestMode

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Steuerelement Clienteingaben des Browser auf gefährliche Werte überprüft.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(Inherited from Control)
ValidatorTextStyle ValidatorTextStyle ValidatorTextStyle ValidatorTextStyle

Ruft einen Verweis auf eine Auflistung von Style-Eigenschaften ab, die die Darstellung von Fehlermeldungen definieren, denen durch das Login-Steuerelement verwendete Bestätigungen zugeordnet sind.Gets a reference to a collection of Style properties that define the appearance of error messages associated with validators used by the Login control.

ViewState ViewState ViewState ViewState

Ruft ein Wörterbuch mit Zustandsinformationen ab, mit dem Sie den Ansichtszustand eines Serversteuerelements über mehrere Anforderungen für dieselbe Seite hinweg speichern und wiederherstellen können.Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

(Inherited from Control)
ViewStateIgnoresCase ViewStateIgnoresCase ViewStateIgnoresCase ViewStateIgnoresCase

Ruft einen Wert ab, der angibt, ob bei dem StateBag-Objekt die Groß- und Kleinschreibung nicht berücksichtigt wird.Gets a value that indicates whether the StateBag object is case-insensitive.

(Inherited from Control)
ViewStateMode ViewStateMode ViewStateMode ViewStateMode

Ruft den Ansichtszustandsmodus des Steuerelements ab oder legt ihn fest.Gets or sets the view-state mode of this control.

(Inherited from Control)
Visible Visible Visible Visible

Ruft einen Wert ab, der angibt, ob ein Serversteuerelement auf der Seite als Benutzeroberfläche gerendert wird.Gets or sets a value that indicates whether a server control is rendered as UI on the page.

(Inherited from Control)
VisibleWhenLoggedIn VisibleWhenLoggedIn VisibleWhenLoggedIn VisibleWhenLoggedIn

Ruft einen Wert ab, der angibt, ob das Login-Steuerelement angezeigt wird, nachdem der Benutzer authentifiziert wurde, oder legt diesen fest.Gets or sets a value indicating whether to show the Login control after the user is authenticated.

Width Width Width Width

Ruft die Breite des Webserver-Steuerelements ab oder legt sie fest.Gets or sets the width of the Web server control.

(Inherited from WebControl)

Methoden

AddAttributesToRender(HtmlTextWriter) AddAttributesToRender(HtmlTextWriter) AddAttributesToRender(HtmlTextWriter) AddAttributesToRender(HtmlTextWriter)

Fügt dem angegebenen HtmlTextWriterTag die darzustellenden HTML-Attribute und -Stile hinzu.Adds HTML attributes and styles that need to be rendered to the specified HtmlTextWriterTag. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.This method is used primarily by control developers.

(Inherited from WebControl)
AddedControl(Control, Int32) AddedControl(Control, Int32) AddedControl(Control, Int32) AddedControl(Control, Int32)

Wird aufgerufen, nachdem ein untergeordnetes Steuerelement zur Controls-Auflistung des Control-Objekts hinzugefügt wurde.Called after a child control is added to the Controls collection of the Control object.

(Inherited from Control)
AddParsedSubObject(Object) AddParsedSubObject(Object) AddParsedSubObject(Object) AddParsedSubObject(Object)

Benachrichtigt das Serversteuerelement, dass entweder ein XML-Element oder HTML-Element analysiert wurde, und fügt das Element dem ControlCollection-Objekt des Serversteuerelements hinzu.Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.

(Inherited from Control)
ApplyStyle(Style) ApplyStyle(Style) ApplyStyle(Style) ApplyStyle(Style)

Kopiert alle nicht leeren Elemente der angegebenen Formatvorlage in das Websteuerelement und überschreibt hierbei alle vorhandenen Formatvorlagenelemente des Steuerelements.Copies any nonblank elements of the specified style to the Web control, overwriting any existing style elements of the control. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.This method is primarily used by control developers.

(Inherited from WebControl)
ApplyStyleSheetSkin(Page) ApplyStyleSheetSkin(Page) ApplyStyleSheetSkin(Page) ApplyStyleSheetSkin(Page)

Übernimmt die im Stylesheet der Seite definierten Stileigenschaften für das Steuerelement.Applies the style properties defined in the page style sheet to the control.

(Inherited from Control)
BeginRenderTracing(TextWriter, Object) BeginRenderTracing(TextWriter, Object) BeginRenderTracing(TextWriter, Object) BeginRenderTracing(TextWriter, Object)

Startet die Entwurfszeitablaufverfolgung des Renderns von Daten.Begins design-time tracing of rendering data.

(Inherited from Control)
BuildProfileTree(String, Boolean) BuildProfileTree(String, Boolean) BuildProfileTree(String, Boolean) BuildProfileTree(String, Boolean)

Sammelt Informationen zum Serversteuerelement und übermittelt sie an die Trace-Eigenschaft, sodass diese angezeigt werden, wenn die Ablaufverfolgung für die Seite aktiviert ist.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(Inherited from Control)
ClearCachedClientID() ClearCachedClientID() ClearCachedClientID() ClearCachedClientID()

Legt den zwischengespeicherten ClientID-Wert auf null fest.Sets the cached ClientID value to null.

(Inherited from Control)
ClearChildControlState() ClearChildControlState() ClearChildControlState() ClearChildControlState()

Löscht die Informationen zum Steuerelementzustand für die untergeordneten Steuerelemente des Serversteuerelements.Deletes the control-state information for the server control's child controls.

(Inherited from Control)
ClearChildState() ClearChildState() ClearChildState() ClearChildState()

Löscht die Informationen zum Ansichtszustand sowie zum Steuerelementzustand für alle untergeordneten Steuerelemente des Serversteuerelements.Deletes the view-state and control-state information for all the server control's child controls.

(Inherited from Control)
ClearChildViewState() ClearChildViewState() ClearChildViewState() ClearChildViewState()

Löscht die Informationen über den Ansichtszustand für alle untergeordneten Steuerelemente des Serversteuerelements.Deletes the view-state information for all the server control's child controls.

(Inherited from Control)
ClearEffectiveClientIDMode() ClearEffectiveClientIDMode() ClearEffectiveClientIDMode() ClearEffectiveClientIDMode()

Legt die ClientIDMode-Eigenschaft der aktuellen Steuerelementinstanz und aller untergeordneten Steuerelemente auf Inherit fest.Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(Inherited from Control)
CopyBaseAttributes(WebControl) CopyBaseAttributes(WebControl) CopyBaseAttributes(WebControl) CopyBaseAttributes(WebControl)

Kopiert die nicht vom Style-Objekt gekapselten Eigenschaften aus dem angegebenen Webserversteuerelement in das Webserversteuerelement, von dem aus diese Methode aufgerufen wird.Copies the properties not encapsulated by the Style object from the specified Web server control to the Web server control that this method is called from. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.This method is used primarily by control developers.

(Inherited from WebControl)
CreateChildControls() CreateChildControls() CreateChildControls() CreateChildControls()

Erstellt die einzelnen Steuerelemente, die das Login-Steuerelement bilden, und ordnet deren Ereignissen Ereignishandler zu.Creates the individual controls that make up the Login control and associates event handlers with their events.

CreateControlCollection() CreateControlCollection() CreateControlCollection() CreateControlCollection()

Erstellt ein neues ControlCollection-Objekt, das die untergeordneten Steuerelemente (sowohl literale als auch Serversteuerelemente) des Serversteuerelements enthält.Creates a new ControlCollection object to hold the child controls (both literal and server) of the server control.

(Inherited from Control)
CreateControlStyle() CreateControlStyle() CreateControlStyle() CreateControlStyle()

Erstellt das Formatvorlagenobjekt, das von der WebControl-Klasse intern zum Implementieren aller auf Formatvorlagen bezogenen Eigenschaften verwendet wird.Creates the style object that is used internally by the WebControl class to implement all style related properties. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.This method is used primarily by control developers.

(Inherited from WebControl)
DataBind() DataBind() DataBind() DataBind()

Bindet eine Datenquelle an das CompositeControl und an alle seine untergeordneten Steuerelemente.Binds a data source to the CompositeControl and all its child controls.

(Inherited from CompositeControl)
DataBind(Boolean) DataBind(Boolean) DataBind(Boolean) DataBind(Boolean)

Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente mit der Option, das DataBinding-Ereignis auszulösen.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(Inherited from Control)
DataBindChildren() DataBindChildren() DataBindChildren() DataBindChildren()

Bindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements.Binds a data source to the server control's child controls.

(Inherited from Control)
Dispose() Dispose() Dispose() Dispose()

Ermöglicht es einem Serversteuerelement, die letzte Bereinigung durchzuführen, bevor es aus dem Speicher freigegeben wird.Enables a server control to perform final clean up before it is released from memory.

(Inherited from Control)
EndRenderTracing(TextWriter, Object) EndRenderTracing(TextWriter, Object) EndRenderTracing(TextWriter, Object) EndRenderTracing(TextWriter, Object)

Beendet die Entwurfszeitablaufverfolgung des Renderns von Daten.Ends design-time tracing of rendering data.

(Inherited from Control)
EnsureChildControls() EnsureChildControls() EnsureChildControls() EnsureChildControls()

Stellt fest, ob das Serversteuerelement untergeordnete Steuerelemente enthält.Determines whether the server control contains child controls. Wenn das nicht der Fall ist, werden untergeordnete Steuerelemente erstellt.If it does not, it creates child controls.

(Inherited from Control)
EnsureID() EnsureID() EnsureID() EnsureID()

Erstellt einen Bezeichner für Steuerelemente, die nicht über einen zugewiesenen Bezeichner verfügen.Creates an identifier for controls that do not have an identifier assigned.

(Inherited from Control)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
FindControl(String) FindControl(String) FindControl(String) FindControl(String)

Durchsucht den aktuellen Benennungscontainer nach dem angegebenen Serversteuerelement mit dem angegebenen id-Parameter.Searches the current naming container for a server control with the specified id parameter.

(Inherited from Control)
FindControl(String, Int32) FindControl(String, Int32) FindControl(String, Int32) FindControl(String, Int32)

Durchsucht den aktuellen Benennungscontainer nach einem Serversteuerelement mit der angegebenen id und einer ganzen Zahl, die im pathOffset-Parameter angegeben ist, der die Suche unterstützt.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. Sie sollten diese Version der FindControl-Methode nicht überschreiben.You should not override this version of the FindControl method.

(Inherited from Control)
Focus() Focus() Focus() Focus()

Legt den Eingabefokus auf ein Steuerelement fest.Sets input focus to a control.

(Inherited from Control)
GetDesignModeState() GetDesignModeState() GetDesignModeState() GetDesignModeState()

Ruft die Entwurfszeitdaten für ein Steuerelement ab.Gets design-time data for a control.

(Inherited from Control)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetRouteUrl(Object) GetRouteUrl(Object) GetRouteUrl(Object) GetRouteUrl(Object)

Ruft die URL ab, die einem Satz von Routenparametern entspricht.Gets the URL that corresponds to a set of route parameters.

(Inherited from Control)
GetRouteUrl(RouteValueDictionary) GetRouteUrl(RouteValueDictionary) GetRouteUrl(RouteValueDictionary) GetRouteUrl(RouteValueDictionary)

Ruft die URL ab, die einem Satz von Routenparametern entspricht.Gets the URL that corresponds to a set of route parameters.

(Inherited from Control)
GetRouteUrl(String, Object) GetRouteUrl(String, Object) GetRouteUrl(String, Object) GetRouteUrl(String, Object)

Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht.Gets the URL that corresponds to a set of route parameters and a route name.

(Inherited from Control)
GetRouteUrl(String, RouteValueDictionary) GetRouteUrl(String, RouteValueDictionary) GetRouteUrl(String, RouteValueDictionary) GetRouteUrl(String, RouteValueDictionary)

Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht.Gets the URL that corresponds to a set of route parameters and a route name.

(Inherited from Control)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
GetUniqueIDRelativeTo(Control) GetUniqueIDRelativeTo(Control) GetUniqueIDRelativeTo(Control) GetUniqueIDRelativeTo(Control)

Gibt den mit einem Präfix versehenen Abschnitt der UniqueID-Eigenschaft des angegebenen Steuerelements zurück.Returns the prefixed portion of the UniqueID property of the specified control.

(Inherited from Control)
HasControls() HasControls() HasControls() HasControls()

Ermittelt, ob das Serversteuerelement untergeordnete Steuerelemente enthält.Determines if the server control contains any child controls.

(Inherited from Control)
HasEvents() HasEvents() HasEvents() HasEvents()

Gibt einen Wert zurück, der angibt, ob Ereignisse für das Steuerelement oder für untergeordnete Steuerelemente registriert werden.Returns a value indicating whether events are registered for the control or any child controls.

(Inherited from Control)
IsLiteralContent() IsLiteralContent() IsLiteralContent() IsLiteralContent()

Ermittelt, ob das Serversteuerelement nur literalen Inhalt enthält.Determines if the server control holds only literal content.

(Inherited from Control)
LoadControlState(Object) LoadControlState(Object) LoadControlState(Object) LoadControlState(Object)

Stellt die Informationen zum Steuerelementzustand aus einer früheren Seitenanforderung wieder her, die durch die SaveControlState()-Methode gespeichert wurden.Restores control-state information from a previous page request that was saved by the SaveControlState() method.

(Inherited from Control)
LoadViewState(Object) LoadViewState(Object) LoadViewState(Object) LoadViewState(Object)

Stellt die Informationen über den Ansichtszustand aus einer früheren Anforderung wieder her, die mit der SaveViewState()-Methode gespeichert wurden.Restores view-state information from a previous request that was saved with the SaveViewState() method.

MapPathSecure(String) MapPathSecure(String) MapPathSecure(String) MapPathSecure(String)

Ruft den physikalischen Pfad ab, auf den ein absoluter bzw. relativer virtueller Pfad verweist.Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(Inherited from Control)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
MergeStyle(Style) MergeStyle(Style) MergeStyle(Style) MergeStyle(Style)

Kopiert alle nicht leeren Elemente der angegebenen Formatvorlage in das Websteuerelement, überschreibt jedoch keine vorhandenen Formatvorlagenelemente des Steuerelements.Copies any nonblank elements of the specified style to the Web control, but will not overwrite any existing style elements of the control. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.This method is used primarily by control developers.

(Inherited from WebControl)
OnAuthenticate(AuthenticateEventArgs) OnAuthenticate(AuthenticateEventArgs) OnAuthenticate(AuthenticateEventArgs) OnAuthenticate(AuthenticateEventArgs)

Löst das Authenticate-Ereignis für die Benutzerauthentifizierung aus.Raises the Authenticate event to authenticate the user.

OnBubbleEvent(Object, EventArgs) OnBubbleEvent(Object, EventArgs) OnBubbleEvent(Object, EventArgs) OnBubbleEvent(Object, EventArgs)

Bestimmt, ob ein Ereignis in der Serversteuerelement-Hierarchie der Benutzeroberfläche der Seite nach oben weitergegeben wird.Determines whether to pass an event up the page's user interface (UI) server control hierarchy.

OnDataBinding(EventArgs) OnDataBinding(EventArgs) OnDataBinding(EventArgs) OnDataBinding(EventArgs)

Löst das DataBinding-Ereignis aus.Raises the DataBinding event.

(Inherited from Control)
OnInit(EventArgs) OnInit(EventArgs) OnInit(EventArgs) OnInit(EventArgs)

Löst das Init-Ereignis aus.Raises the Init event.

(Inherited from Control)
OnLoad(EventArgs) OnLoad(EventArgs) OnLoad(EventArgs) OnLoad(EventArgs)

Löst das Load-Ereignis aus.Raises the Load event.

(Inherited from Control)
OnLoggedIn(EventArgs) OnLoggedIn(EventArgs) OnLoggedIn(EventArgs) OnLoggedIn(EventArgs)

Löst das LoggedIn-Ereignis aus, nachdem sich der Benutzer bei der Website angemeldet hat und authentifiziert wurde.Raises the LoggedIn event after the user logs in to the Web site and has been authenticated.

OnLoggingIn(LoginCancelEventArgs) OnLoggingIn(LoginCancelEventArgs) OnLoggingIn(LoginCancelEventArgs) OnLoggingIn(LoginCancelEventArgs)

Löst das LoggingIn-Ereignis aus, wenn ein Benutzer Anmeldeinformationen vor der Authentifizierung sendet.Raises the LoggingIn event when a user submits login information but before the authentication takes place.

OnLoginError(EventArgs) OnLoginError(EventArgs) OnLoginError(EventArgs) OnLoginError(EventArgs)

Löst nach einem fehlgeschlagenen Anmeldeversuch das LoginError-Ereignis aus.Raises the LoginError event when a login attempt fails.

OnPreRender(EventArgs) OnPreRender(EventArgs) OnPreRender(EventArgs) OnPreRender(EventArgs)

Implementiert die OnPreRender(EventArgs)-Basismethode.Implements the base OnPreRender(EventArgs) method.

OnUnload(EventArgs) OnUnload(EventArgs) OnUnload(EventArgs) OnUnload(EventArgs)

Löst das Unload-Ereignis aus.Raises the Unload event.

(Inherited from Control)
OpenFile(String) OpenFile(String) OpenFile(String) OpenFile(String)

Ruft einen Stream zum Lesen einer Datei ab.Gets a Stream used to read a file.

(Inherited from Control)
RaiseBubbleEvent(Object, EventArgs) RaiseBubbleEvent(Object, EventArgs) RaiseBubbleEvent(Object, EventArgs) RaiseBubbleEvent(Object, EventArgs)

Weist dem übergeordneten Element des Steuerelements alle Ereignisquellen und zugehörige Informationen zu.Assigns any sources of the event and its information to the control's parent.

(Inherited from Control)
RecreateChildControls() RecreateChildControls() RecreateChildControls() RecreateChildControls()

Erstellt in einem von CompositeControl abgeleiteten Steuerelement die untergeordneten Steuerelemente neu.Recreates the child controls in a control derived from CompositeControl.

(Inherited from CompositeControl)
RemovedControl(Control) RemovedControl(Control) RemovedControl(Control) RemovedControl(Control)

Wird aufgerufen, nachdem ein untergeordnetes Steuerelement aus der Controls-Auflistung des Control-Objekts entfernt wurde.Called after a child control is removed from the Controls collection of the Control object.

(Inherited from Control)
Render(HtmlTextWriter) Render(HtmlTextWriter) Render(HtmlTextWriter) Render(HtmlTextWriter)

Rendert das Anmeldeformular mit dem angegebenen HTML-Writer.Renders the login form using the specified HTML writer.

RenderBeginTag(HtmlTextWriter) RenderBeginTag(HtmlTextWriter) RenderBeginTag(HtmlTextWriter) RenderBeginTag(HtmlTextWriter)

Gibt das öffnende HTML-Tag des Steuerelements im angegebenen Writer wieder.Renders the HTML opening tag of the control to the specified writer. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.This method is used primarily by control developers.

(Inherited from WebControl)
RenderChildren(HtmlTextWriter) RenderChildren(HtmlTextWriter) RenderChildren(HtmlTextWriter) RenderChildren(HtmlTextWriter)

Gibt den Inhalt der untergeordneten Elemente eines Serversteuerelements an ein bereitgestelltes HtmlTextWriter-Objekt aus, das den Inhalt zum Rendern auf den Client schreibt.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Inherited from Control)
RenderContents(HtmlTextWriter) RenderContents(HtmlTextWriter) RenderContents(HtmlTextWriter) RenderContents(HtmlTextWriter)

Rendert den Inhalt des Steuerelements im angegebenen Writer.Renders the contents of the control to the specified writer. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.This method is used primarily by control developers.

(Inherited from WebControl)
RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter)

Gibt Inhalte von Serversteuerelementen an ein bereitgestelltes HtmlTextWriter-Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, sofern die Ablaufverfolgung aktiviert ist.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(Inherited from Control)
RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter)

Gibt Inhalte von Serversteuerelementen mithilfe eines bereitgestellten HtmlTextWriter-Objekts an ein bereitgestelltes ControlAdapter-Objekt aus.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Inherited from Control)
RenderEndTag(HtmlTextWriter) RenderEndTag(HtmlTextWriter) RenderEndTag(HtmlTextWriter) RenderEndTag(HtmlTextWriter)

Stellt das schließende HTML-Tag des Steuerelements im angegebenen Writer dar.Renders the HTML closing tag of the control into the specified writer. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.This method is used primarily by control developers.

(Inherited from WebControl)
ResolveAdapter() ResolveAdapter() ResolveAdapter() ResolveAdapter()

Ruft den Steuerelementadapter ab, der für das Rendern des angegebenen Steuerelements verantwortlich ist.Gets the control adapter responsible for rendering the specified control.

(Inherited from Control)
ResolveClientUrl(String) ResolveClientUrl(String) ResolveClientUrl(String) ResolveClientUrl(String)

Ruft eine URL ab, die vom Browser verwendet werden kann.Gets a URL that can be used by the browser.

(Inherited from Control)
ResolveUrl(String) ResolveUrl(String) ResolveUrl(String) ResolveUrl(String)

Konvertiert eine URL in eine vom anfordernden Client verwendbare URL.Converts a URL into one that is usable on the requesting client.

(Inherited from Control)
SaveControlState() SaveControlState() SaveControlState() SaveControlState()

Speichert alle Zustandsänderungen des Serversteuerelements, die seit dem Zeitpunkt aufgetreten sind, zu dem die Seite an den Server zurückgesendet wurde.Saves any server control state changes that have occurred since the time the page was posted back to the server.

(Inherited from Control)
SaveViewState() SaveViewState() SaveViewState() SaveViewState()

Speichert jeden Zustand, der nach dem Aufrufen der TrackViewState()-Methode geändert wurde.Saves any state that was modified after the TrackViewState() method was invoked.

SetDesignModeState(IDictionary) SetDesignModeState(IDictionary) SetDesignModeState(IDictionary) SetDesignModeState(IDictionary)

Legt die Entwurfszeitdaten für ein Steuerelement fest.Sets design-time data for a control.

SetRenderMethodDelegate(RenderMethod) SetRenderMethodDelegate(RenderMethod) SetRenderMethodDelegate(RenderMethod) SetRenderMethodDelegate(RenderMethod)

Beauftragt einen Ereignishandlerdelegaten, das Serversteuerelement und seinen Inhalt im übergeordneten Steuerelement zu rendern.Assigns an event handler delegate to render the server control and its content into its parent control.

(Inherited from Control)
SetTraceData(Object, Object) SetTraceData(Object, Object) SetTraceData(Object, Object) SetTraceData(Object, Object)

Legt Ablaufverfolgungsdaten für die Nachverfolgung der Entwurfszeit von Rendering-Daten mithilfe des Ablaufverfolgungsdatenschlüssels und Ablaufverfolgungsdatenwerts fest.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(Inherited from Control)
SetTraceData(Object, Object, Object) SetTraceData(Object, Object, Object) SetTraceData(Object, Object, Object) SetTraceData(Object, Object, Object)

Legt Ablaufverfolgungsdaten für die Nachverfolgung der Entwurfszeit von Rendering-Daten mithilfe des verfolgten Objekts, des Ablaufverfolgungsdatenschlüssels und Ablaufverfolgungsdatenwerts fest.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(Inherited from Control)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)
TrackViewState() TrackViewState() TrackViewState() TrackViewState()

Überschreibt die TrackViewState()-Basismethode.Overrides the base TrackViewState() method.

Ereignisse

Authenticate Authenticate Authenticate Authenticate

Tritt beim Authentifizieren eines Benutzers ein.Occurs when a user is authenticated.

DataBinding DataBinding DataBinding DataBinding

Tritt ein, wenn das Serversteuerelement eine Bindung an eine Datenquelle durchführt.Occurs when the server control binds to a data source.

(Inherited from Control)
Disposed Disposed Disposed Disposed

Tritt ein, wenn ein Serversteuerelement im Speicher freigegeben wird. Dies ist die letzte Stufe des Lebenszyklus des Serversteuerelements bei der Anforderung einer ASP.NET-Seite.Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.

(Inherited from Control)
Init Init Init Init

Tritt bei der Initialisierung des Serversteuerelements ein. Dies ist der erste Schritt in dessen Lebenszyklus.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Inherited from Control)
Load Load Load Load

Tritt ein, wenn das Serversteuerelement in das Page-Objekt geladen wird.Occurs when the server control is loaded into the Page object.

(Inherited from Control)
LoggedIn LoggedIn LoggedIn LoggedIn

Tritt ein, wenn sich der Benutzer bei der Website anmeldet und authentifiziert wurde.Occurs when the user logs in to the Web site and has been authenticated.

LoggingIn LoggingIn LoggingIn LoggingIn

Tritt ein, wenn ein Benutzer Anmeldeinformationen sendet, bevor die Authentifizierung erfolgt ist.Occurs when a user submits login information, before authentication takes place.

LoginError LoginError LoginError LoginError

Tritt ein, wenn ein Anmeldefehler festgestellt wird.Occurs when a login error is detected.

PreRender PreRender PreRender PreRender

Tritt nach dem Laden des Control-Objekts, jedoch vor dem Rendern ein.Occurs after the Control object is loaded but prior to rendering.

(Inherited from Control)
Unload Unload Unload Unload

Tritt ein, wenn das Serversteuerelement aus dem Speicher entladen wird.Occurs when the server control is unloaded from memory.

(Inherited from Control)

Explizite Schnittstellenimplementierungen

IAttributeAccessor.GetAttribute(String) IAttributeAccessor.GetAttribute(String) IAttributeAccessor.GetAttribute(String) IAttributeAccessor.GetAttribute(String)

Ruft ein Attribut des Websteuerelements mit dem angegebenen Namen ab.Gets an attribute of the Web control with the specified name.

(Inherited from WebControl)
IAttributeAccessor.SetAttribute(String, String) IAttributeAccessor.SetAttribute(String, String) IAttributeAccessor.SetAttribute(String, String) IAttributeAccessor.SetAttribute(String, String)

Legt zum angegebenen Namen und Wert ein Attribut des Websteuerelements fest.Sets an attribute of the Web control to the specified name and value.

(Inherited from WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls() ICompositeControlDesignerAccessor.RecreateChildControls() ICompositeControlDesignerAccessor.RecreateChildControls() ICompositeControlDesignerAccessor.RecreateChildControls()

Ermöglicht es einem Designer, die Auflistung der untergeordneten Steuerelemente eines zusammengesetzten Steuerelements in der Entwurfszeitumgebung erneut zu erstellen.Enables a designer to recreate the composite control's collection of child controls in the design-time environment.

(Inherited from CompositeControl)
IControlDesignerAccessor.GetDesignModeState() IControlDesignerAccessor.GetDesignModeState() IControlDesignerAccessor.GetDesignModeState() IControlDesignerAccessor.GetDesignModeState()

Eine Beschreibung dieses Elements finden Sie unter GetDesignModeState().For a description of this member, see GetDesignModeState().

(Inherited from Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary) IControlDesignerAccessor.SetDesignModeState(IDictionary) IControlDesignerAccessor.SetDesignModeState(IDictionary) IControlDesignerAccessor.SetDesignModeState(IDictionary)

Eine Beschreibung dieses Members finden Sie unter SetDesignModeState(IDictionary).For a description of this member, see SetDesignModeState(IDictionary).

(Inherited from Control)
IControlDesignerAccessor.SetOwnerControl(Control) IControlDesignerAccessor.SetOwnerControl(Control) IControlDesignerAccessor.SetOwnerControl(Control) IControlDesignerAccessor.SetOwnerControl(Control)

Eine Beschreibung dieses Members finden Sie unter SetOwnerControl(Control).For a description of this member, see SetOwnerControl(Control).

(Inherited from Control)
IParserAccessor.AddParsedSubObject(Object) IParserAccessor.AddParsedSubObject(Object) IParserAccessor.AddParsedSubObject(Object) IParserAccessor.AddParsedSubObject(Object)

Eine Beschreibung dieses Elements finden Sie unter AddParsedSubObject(Object).For a description of this member, see AddParsedSubObject(Object).

(Inherited from Control)

Erweiterungsmethoden

FindDataSourceControl(Control) FindDataSourceControl(Control) FindDataSourceControl(Control) FindDataSourceControl(Control)

Gibt die Datenquelle zurück, die dem Datensteuerelement für das angegebene Steuerelement zugeordnet ist.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String) FindFieldTemplate(Control, String) FindFieldTemplate(Control, String) FindFieldTemplate(Control, String)

Gibt die Feldvorlage für die angegebene Spalte im Benennungscontainer des angegebenen Steuerelements zurück.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control) FindMetaTable(Control) FindMetaTable(Control) FindMetaTable(Control)

Gibt das Metatabellenobjekt für das enthaltende Datensteuerelement zurück.Returns the metatable object for the containing data control.

GetDefaultValues(INamingContainer) GetDefaultValues(INamingContainer) GetDefaultValues(INamingContainer) GetDefaultValues(INamingContainer)

Ruft die Auflistung der Standardwerte für das angegebene Datensteuerelement ab.Gets the collection of the default values for the specified data control.

GetMetaTable(INamingContainer) GetMetaTable(INamingContainer) GetMetaTable(INamingContainer) GetMetaTable(INamingContainer)

Ruft die Tabellenmetadaten für das angegebene Datensteuerelement ab.Gets the table metadata for the specified data control.

SetMetaTable(INamingContainer, MetaTable) SetMetaTable(INamingContainer, MetaTable) SetMetaTable(INamingContainer, MetaTable) SetMetaTable(INamingContainer, MetaTable)

Legt die Tabellenmetadaten für das angegebene Datensteuerelement fest.Sets the table metadata for the specified data control.

SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)

Legt die Zuordnung für Tabellenmetadaten und Standardwerte für das angegebene Datensteuerelement fest.Sets the table metadata and default value mapping for the specified data control.

SetMetaTable(INamingContainer, MetaTable, Object) SetMetaTable(INamingContainer, MetaTable, Object) SetMetaTable(INamingContainer, MetaTable, Object) SetMetaTable(INamingContainer, MetaTable, Object)

Legt die Zuordnung für Tabellenmetadaten und Standardwerte für das angegebene Datensteuerelement fest.Sets the table metadata and default value mapping for the specified data control.

TryGetMetaTable(INamingContainer, MetaTable) TryGetMetaTable(INamingContainer, MetaTable) TryGetMetaTable(INamingContainer, MetaTable) TryGetMetaTable(INamingContainer, MetaTable)

Bestimmt, ob Tabellenmetadaten verfügbar sind.Determines whether table metadata is available.

EnableDynamicData(INamingContainer, Type) EnableDynamicData(INamingContainer, Type) EnableDynamicData(INamingContainer, Type) EnableDynamicData(INamingContainer, Type)

Aktiviert das Verhalten dynamischer Daten für das angegebene DatensteuerelementEnables Dynamic Data behavior for the specified data control.

EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)

Aktiviert das Verhalten dynamischer Daten für das angegebene DatensteuerelementEnables Dynamic Data behavior for the specified data control.

EnableDynamicData(INamingContainer, Type, Object) EnableDynamicData(INamingContainer, Type, Object) EnableDynamicData(INamingContainer, Type, Object) EnableDynamicData(INamingContainer, Type, Object)

Aktiviert das Verhalten dynamischer Daten für das angegebene DatensteuerelementEnables Dynamic Data behavior for the specified data control.

Gilt für:

Siehe auch