Gewusst wie: Hinzufügen von Serversteuerelementen zu einer ASP.NET-Webseite mittels ASP.NET-Syntax

Aktualisiert: November 2007

Sie können einer Seite ein Webserversteuerelement hinzufügen, indem Sie es direkt in der ASPX-Datei deklarieren.

Hinweis:
Hintergrundinformationen über Steuerelemente für ASP.NET-Webseiten finden Sie unter Übersicht über ASP.NET-Webserversteuerelemente.

So fügen Sie ein Steuerelement deklarativ hinzu

1. Wenn Sie sich in einem visuellen Designer befinden, wechseln Sie zur Quellbearbeitungsansicht.

2. Geben Sie das Element, das das Steuerelement darstellt, in die ASPX-Datei ein. Die genaue Syntax richtet sich nach dem Steuerelement, das hinzugefügt wird. Jedoch gilt i. d. R. Folgendes:

   • Steuerelemente müssen das Attribut aufweisen.

   • Legen Sie das ID-Attribut des Steuerelements fest, es sei denn, das Steuerelement ist Teil eines komplexen Steuerelements und wird wiederholt (wie in den Steuerelementen GridView, FormView, DetailsView, Repeater oder DataList).

   • Webserversteuerelemente werden mit einem XML-Tag deklariert, das auf den asp-Namespace verweist.

   • Steuerelementdeklarationen müssen ordnungsgemäß geschlossen werden. Sie können ein explizites Endtag angeben oder, wenn das Steuerelement keine untergeordneten Elemente besitzt, ein Tag angeben, das sich selbst schließt. Die einzige Ausnahme bilden HTML-Eingabesteuerelemente, die wie Eingabesteuerelemente keine untergeordneten Elemente besitzen können (z. B. Deklarative Syntax des HtmlInputText-Serversteuerelements, Deklarative Syntax des HtmlImage-Serversteuerelements und Deklarative Syntax des HtmlButton-Serversteuerelements).

   • Eigenschaften von Steuerelementen werden als Attribute deklariert.

     Die folgenden Beispiele zeigen typische Deklarationen für Webserversteuerelemente:

     <!-- Textbox Web server control -->
     <asp:textbox id="TextBox1" runat="Server" Text=""></asp:textbox>
     
     <!-- Same, but with self-closing element -->
     <asp:textbox id="Textbox2" runat="Server" Text="" />
     
     <!-- Web DropDownList control, which contains subelements -->
     <asp:DropDownList id="DropDown1" >
        <asp:ListItem Value="0">0</asp:ListItem>
        <asp:ListItem Value="1">1</asp:ListItem>
        <asp:ListItem Value="2">2</asp:ListItem>
        <asp:ListItem Value="3">3</asp:ListItem>
     </asp:DropDownList>
     
     <asp:Repeater id="Repeater2" >
        <HeaderTemplate>
            Company data:
        </HeaderTemplate>
        <ItemTemplate>
            <asp:Label ID="Label1"  
                  Font-Names="verdana" Font-Size="10pt"
                  Text='<%# Eval("Name") %>' />
            ( <asp:Label ID="Label2" 
                  Font-Names="verdana" Font-Size="10pt"
                  Text='<%# Eval("Ticker") %>'/>
             )
        </ItemTemplate>
        <SeparatorTemplate>
            ,
        </SeparatorTemplate>
     </asp:Repeater>
     

     <!-- Textbox Web server control -->
     <asp:textbox id="TextBox1" runat="Server" Text=""></asp:textbox>
     
     <!-- Same, but with self-closing element -->
     <asp:textbox id="Textbox2" runat="Server" Text="" />
     
     <!-- Web DropDownList control, which contains subelements -->
     <asp:DropDownList id="DropDown1" >
        <asp:ListItem Value="0">0</asp:ListItem>
        <asp:ListItem Value="1">1</asp:ListItem>
        <asp:ListItem Value="2">2</asp:ListItem>
        <asp:ListItem Value="3">3</asp:ListItem>
     </asp:DropDownList>
     
     <asp:Repeater id="Repeater2" >
        <HeaderTemplate>
            Company data:
        </HeaderTemplate>
        <ItemTemplate>
            <asp:Label ID="Label1"  
                  Font-Names="verdana" Font-Size="10pt"
                  Text='<%# Eval("Name") %>' />
            ( <asp:Label ID="Label2" 
                  Font-Names="verdana" Font-Size="10pt"
                  Text='<%# Eval("Ticker") %>'/>
             )
        </ItemTemplate>
        <SeparatorTemplate>
            ,
        </SeparatorTemplate>
     </asp:Repeater>
     

     Informationen über die deklarative Syntax für bestimmte Webserversteuerelemente finden Sie unter Syntax des Webserversteuerelements.

     Hinweis:
     Wenn der Seiten-Designer ein Webserversteuerelement nicht korrekt darstellen kann, wird ein graues Feld mit dem Text "Fehler beim Erstellen des Steuerelements" angezeigt. Häufig bedeutet dies, dass die ASP.NET-Syntax des Steuerelements fehlerhaft ist. Diese Fehlermeldung wird z. B. dann angezeigt, wenn in einem Webserversteuerelement das -Attribut fehlt.

Siehe auch

Aufgaben

Gewusst wie: Programmgesteuertes Festlegen von Formateigenschaften für ASP.NET-Serversteuerelemente

Gewusst wie: Festlegen von Formateigenschaften für ASP.NET-Serversteuerelemente mit ASP.NET-Syntax

Gewusst wie: Programmgesteuertes Festlegen der Eigenschaften von HTML-Serversteuerelementen

Konzepte

Übersicht über ASP.NET-Webserversteuerelemente