Freigeben über


Verwenden eines Benutzersteuerelements in einer Web Forms-Seite

Benutzersteuerelemente müssen in eine Web Forms-Seite eingebunden werden, damit sie ausgeführt werden können. Wenn eine Seite angefordert wird, die ein Benutzersteuerelement enthält, durchläuft das Benutzersteuerelement alle Verarbeitungsstadien, die auch ASP.NET-Serversteuerelemente durchlaufen. Weitere Informationen über diese Verarbeitungsstadien finden Sie unter Verarbeiten von Web Forms-Seiten.

Ein Benutzersteuerelement kann einfach und schnell in eine Web Forms-Seite eingebunden werden.

So binden Sie ein Benutzersteuerelement in eine Web Forms-Seite ein

  1. Deklarieren Sie in der Web Forms-Seite eine @ Register-Direktive mit folgendem Inhalt:

    • Ein tagprefix-Attribut, um ein Präfix mit dem Benutzersteuerelement zu verknüpfen. Dieses Präfix wird in das öffnende Tag des Benutzersteuerelements eingefügt.

    • Ein tagname-Attribut, um einen Namen mit dem Benutzersteuerelement zu verknüpfen. Dieser Name wird in das öffnende Tag des Benutzersteuerelements eingefügt.

    • Ein Src-Attribut, um den virtuellen Pfad der Datei für das Benutzersteuerelement zu definieren, das in die Web Forms-Seite eingebunden werden soll.

      Hinweis   Das Src-Attribut kann einen relativen oder einen absoluten Pfad aus dem Stammverzeichnis der Anwendung zur Quelldatei des Benutzersteuerelements als Wert enthalten. Für die einfachere Verwendung empfiehlt sich ein relativer Pfad. Die Tilde (~) stellt das Stammverzeichnis der Anwendung dar.

    Durch den folgenden Code wird z. B. ein in der Datei Login1.ascx definiertes Benutzersteuerelement registriert. Das Tagpräfix lautet Acme, der Tagname Login. Die Datei befindet sich im Controls-Verzeichnis.

    <%@ Register TagPrefix="Acme" TagName="Login" Src="~\controls\login1.ascx" %>
    
  2. Verwenden Sie die Syntax für benutzerdefinierte Serversteuerelemente, und deklarieren Sie das Benutzersteuerelement zwischen den öffnenden und schließenden Tags des HtmlForm-Serversteuerelements (<form runat=server></form>). Um das im vorherigen Schritt importierte Steuerelement zu deklarieren, verwenden Sie beispielsweise folgende Syntax.

    <html>
    <body>
    <form runat="server">
    <Acme:Login id="MyLogin" runat="server"/>
    </form>
    </body>
    </html>
    

    Hinweis   Unabhängig davon, wie viele ASP.NET-Serversteuerelemente (Benutzersteuerelemente und alle anderen) Sie in Ihre Web Forms-Seite einbinden, können Sie nur ein HtmlForm-Serversteuerelement in einer Web Forms-Seite einbinden. Fügen Sie alle Serversteuerelemente zwischen den öffnenden und schließenden Tags dieses Steuerelements ein.

Siehe auch

Benutzersteuerelemente für Web Forms | Erstellen eines Benutzersteuerelements | Serverereignisbehandlung in Web Forms-Seiten | Behandeln von Ereignissen eines Benutzersteuerelements