Registrieren einer Assembly in einem WebForm zur Verwendung eines benutzerdefinierten Steuerelements

Dieser Artikel enthält Informationen zum Verfügbarmachen und Registrieren einer Assembly in einem WebForm zur Verwendung mit ASP.NET benutzerdefinierten Serversteuerelementen.

              Originale Produktversion: ASP.NET
Ursprüngliche KB-Nummer: 321749

Beispielassemblyeigenschaften

Um als benutzerdefiniertes Serversteuerelement dargestellt zu werden, muss die Assembly über eine Klasse verfügen, die direkt oder indirekt von System.Web.UI.Control abgeleitet wird, und Sie müssen die Klasse in einen Namespace einschließen. Beispiele in diesem Artikel gehen davon aus, dass die -Klasse im CustomControlNamespace Namespace eingeschlossen ist und die Assembly erfolgreich in einer Datei namensCustomControl.dllkompiliert wurde.

Verfügbarmachen einer Assembly für ASP.NET Anwendung

Um eine Assembly für eine ASP.NET Anwendung verfügbar zu machen, müssen Sie die .dll der Assembly im /bin Ordner der Anwendung ablegen.

1. Navigieren Sie zum Stammverzeichnis der Anwendung in Windows Explorer.

   So finden Sie heraus, was der Ordner des Anwendungsprojekts ist:

   1. Wählen Sie in der .NET-Umgebung im Menü Ansichtdie Option Projektmappen-Explorer aus.
   2. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf ein Projekt Standard Element, und wählen Sie Eigenschaften aus.
   3. Wählen Sie im Dialogfeld Projekteigenschaften die Option Allgemeine Eigenschaften und dann Allgemein aus.

   Im Strukturbereich wird die Liste mit der Eigenschaft Projektordner angezeigt. Dies ist in der Regel das Stammverzeichnis der Anwendung.

2. Erstellen Sie in einem Webanwendungsprojektordner einen Ordner namens bin , falls er nicht vorhanden ist.

3. Kopieren oder verschieben Sie die .dll der Assembly in diesen Ordner. Sie können das Steuerelement jetzt von jeder ASP.NET Seite im Stammverzeichnis Ihrer Anwendung (oder einem der zugehörigen Unterordner) verwenden.

Registrieren der Assembly in einem ASP.NET-Anwendungswebformular

Öffnen Sie in einer .NET-Programmierumgebung das Form.aspx-Quellfenster, und fügen Sie das folgende Tag oben im Code hinzu:

<%@ Register TagPrefix="Custom" Namespace="CustomControlNamespace" Assembly= "CustomControl" %>

Im obigen Code gilt Folgendes:

• Custom ist ein Alias, den Sie einem Namespace zuordnen.
• CustomControlNamespace ist ein Namespace, in den Klassen einer Assembly eingeschlossen sind.
• CustomControl ist der Name der Assemblydatei ohne Erweiterung (.dll).

Ändern Sie in Ihrem Code diese Parameter in die entsprechenden Namen für Ihre Assembly.

Jetzt wird die Assembly in einem Webformular registriert. Sie können diese registrierte Assembly in Ihrem ASP.NET Code mit den ausgewählten Namen verwenden. Das Tag könnte beispielsweise wie folgt aussehen:

<Custom:CustomControl id="CustomControl1" parameter1="value1" parameter2="value2" runat="server"/>

Im obigen Custom Tag ist der ausgewählte Name für den Namespace der Assembly, CustomControl ist der Name des benutzerdefinierten Serversteuerelements und parameter 1 und parameter2 sind optionale Steuerelementeigenschaften, die je nach ihrem tatsächlichen Code variieren.