Gewusst wie: Einfügen eines Benutzersteuerelements in eine ASP.NET-Webseite

  • Artikel

Aktualisiert: November 2007

Um ein Benutzersteuerelement zu verwenden, fügen Sie es in eine ASP.NET-Webseite ein. 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 Übersicht über den Lebenszyklus von ASP.NET-Seiten.

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

  1. Erstellen Sie in der enthaltenden ASP.NET-Webseite eine @ Register-Direktive, die Folgendes enthält:

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

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

    • Ein Src-Attribut, das den virtuellen Pfad zur Benutzersteuerelementdatei definiert, die Sie einschließen.

      Hinweis:

      Der Src-Attributwert kann ein relativer oder ein absoluter Pfad zur Quelldatei des Benutzersteuerelements aus dem Stammverzeichnis der Anwendung sein. Aus Gründen der Flexibilität empfiehlt sich ein relativer Pfad. Die Tilde (~) stellt das Stammverzeichnis der Anwendung dar. Benutzersteuerelemente dürfen sich nicht im Verzeichnis App_Code befinden.

  2. Deklarieren Sie im Text der Webseite das Benutzersteuerelementelement im form-Element.

  3. Wenn das Benutzersteuerelement öffentliche Eigenschaften verfügbar macht, können Sie die Eigenschaften deklarativ festlegen.

Beispiel

Im folgenden Beispiel wird eine ASP.NET-Webseite gezeigt, die ein Benutzersteuerelement enthält. Das Benutzersteuerelement befindet sich im Ordner Controls in der Datei Spinner.ascx. In der Seite ist das Steuerelement mit dem Präfix uc und dem Tagnamen Spinner registriert. Die MinValue-Eigenschaft und die MaxValue-Eigenschaft des Benutzersteuerelements werden deklarativ festgelegt.

Hinweis:

Ausführliche Informationen über den Code für das in diesem Beispiel verwendete Benutzersteuerelement finden Sie unter Gewusst wie: Erstellen von ASP.NET-Benutzersteuerelementen.

 
<%@ Page Language="VB" %>
<%@ Register TagPrefix="uc" TagName="Spinner" 
    Src="~\Controls\Spinner.ascx" %>
<html>
<body>
<form >
    <uc:Spinner id="Spinner1" 
         
        MinValue="1" 
        MaxValue="10" />
</form>
</body>

<%@ Page Language="C#" %>
<%@ Register TagPrefix="uc" TagName="Spinner" 
    Src="~\Controls\Spinner.ascx" %>
<html>
<body>
<form >
    <uc:Spinner id="Spinner1" 
         
        MinValue="1" 
        MaxValue="10" />
</form>
</body>

Siehe auch

Konzepte

Übersicht über ASP.NET-Benutzersteuerelemente

Wegweiser zur Erstellung benutzerdefinierter ASP.NET-Steuerelemente