Registrieren einer Assembly in einem WebForm zum Verwenden eines benutzerdefinierten Steuerelements

Dieser Artikel enthält Informationen, um eine Assembly in einem WebForm zur Verfügung zu stellen und zu registrieren, die mit ASP.NET benutzerdefinierten Serversteuerelementen verwendet werden kann.

Ursprüngliche 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 dieser 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 dass die Assembly erfolgreich in einer Datei mit dem Namen CustomControl.dll kompiliert wurde.

Bereitstellung 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 in den /bin Ordner der Anwendung einfügen.

1. Navigieren Sie zum Stammverzeichnis der Anwendung im Windows-Explorer.

   So finden Sie heraus, was der Anwendungsprojektordner ist:

   1. Wählen Sie in der .NET-Umgebung unter dem Menü "Ansicht" Projektmappen-Explorer aus.
   2. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf ein Projekthauptelement, 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 mit dem Namen "bin ", wenn er nicht vorhanden ist.

3. Kopieren oder verschieben Sie die .dll der Assembly in diesem Ordner. Sie können das Steuerelement jetzt von einer beliebigen ASP.NET Seite im Stammverzeichnis Ihrer Anwendung (oder eines seiner Unterordner) verwenden.

Registrieren der Assembly in einem ASP.NET Anwendungswebformular

Öffnen Sie in einer .NET-Programmierumgebung das Form.aspx Quellfenster, und fügen Sie oben im Code das folgende Tag 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 dem 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 Die 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 z. B. wie folgt sein:

<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 der name des benutzerdefinierten Serversteuerelements und parameter 1 parameter2 optionale Steuerelementeigenschaften, die je nach dem tatsächlichen Code variieren.