Registrieren einer Assembly in einem WebForm zur Verwendung eines benutzerdefinierten Steuerelements

  • Artikel
  • 2 Minuten Lesedauer

Dieser Artikel enthält Informationen zum Bereitstellen und Registrieren einer Assembly, die in einem WebForm zur Verwendung mit ASP.NET benutzerdefinierten Serversteuerelementen verfügbar ist.

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 abgeleitet System.Web.UI.Control ist, und Sie müssen die Klasse in einen Namespace einschließen. In den Beispielen in diesem Artikel wird davon ausgegangen, dass die Klasse in den Namespace eingeschlossen ist CustomControlNamespace und dass die Assembly erfolgreich in einer Datei namens CustomControl.dll kompiliert wurde.

Eine Assembly für ASP.NET Anwendung verfügbar machen

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 platzieren.

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

    So finden Sie heraus, was der Anwendungsprojektordner ist:

    1. Wählen Sie in der .NET-Umgebung im Menü "Ansicht" den Projektmappen-Explorer aus.
    2. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf ein Projekthauptelement, und wählen Sie "Eigenschaften" aus.
    3. Wählen Sie im Dialogfeld Project Eigenschaften die Option "Allgemeine Eigenschaften" und dann "Allgemein" aus.

    Im Strukturbereich wird die Liste mit der Project Folder-Eigenschaft 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 Der Anwendung (oder einem seiner Unterordner) verwenden.

Registrieren der Assembly in einem ASP.NET Anwendungswebformular

Öffnen Sie in einer .NET-Programmierumgebung das Quellfenster Form.aspx, 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 diese Parameter im Code in die entsprechenden Namen für die Assembly.

Jetzt ist 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 folgendermaßen sein:

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

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