Erstellen der Beispiele für benutzerdefinierte Serversteuerelemente

Článek
10/22/2014

Aktualisiert: November 2007

Dieses Thema beschreibt die Kompilierung von Beispielen für benutzerdefinierte Steuerelemente in eine Assembly und die Verwendung von Steuerelementen in ASP.NET-Webseiten. Außerdem wird beschrieben, wie Sie den Ordner App_Code einer ASP.NET-Website verwenden können, um den Steuerelementcode ohne Kompilierung zu testen.

Erstellen einer Steuerelementassembly

So erstellen und kompilieren Sie die benutzerdefinierten Steuerelemente in eine Assembly

Erstellen Sie einen Ordner für die Quelldateien der benutzerdefinierten Steuerelemente und zugehörigen Klassen.
Erstellen Sie eine Textdatei mit der entsprechenden Spracherweiterung für jedes Beispiel, das Sie kompilieren möchten.

Erstellen Sie z. B. eine Datei mit dem Namen MailLink.cs für den C#-Code des MailLink-Steuerelements in dem Beispiel für das Rendering eines Webserversteuerelements.
Kopieren und fügen Sie den Quellcode für jedes Beispiel in die entsprechende Textdatei ein, und speichern Sie die Datei.

Führen Sie den folgenden Befehl vom Quellcodeordner aus, um die Steuerelemente und die zugehörigen Klassen in eine Assembly zu kompilieren.

csc /t:library /out:Samples.AspNet.CS.Controls.dll /r:System.dll 
/r:System.Web.dll /r:System.Design.dll *.cs

vbc /t:library /out:Samples.AspNet.VB.Controls.dll /r:System.dll 
/r:System.Web.dll /r:System.Design.dll *.vb

Aufgrund der /t:library-Compileroption erstellt der Compiler eine Bibliothek (anstelle einer ausführbaren Assembly). Die /out-Option stellt einen Namen für die Assembly bereit, und die /r-Option listet die Assemblys auf, die mit Ihrer Assembly verknüpft sind.

Hinweis:
Wenn Sie den Compilerbefehl nicht ausführen können, müssen Sie den .NET Framework-Installationspfad zur PATH-Variablen in Windows hinzufügen, bevor Sie den Befehl ausführen. Klicken Sie in Windows mit der rechten Maustaste auf Arbeitsplatz. Klicken Sie auf Eigenschaften, dann auf die Registerkarte Erweitert und anschließend auf die Schaltfläche Umgebungsvariablen. Doppelklicken Sie in der Liste Systemvariablen auf die Path-Variable. Fügen Sie in dem Textfeld Variablenwert ein Semikolon (;) hinter die im Textfeld vorhandenen Werte ein, und geben Sie dann den Pfad Ihrer .NET Framework-Installation ein. .NET Framework wird normalerweise im Windows-Installationsordner unter \Microsoft.NET\Framework\Versionsnummer installiert.

Wenn Sie den Compilerbefehl nicht ausführen können, müssen Sie den .NET Framework-Installationspfad zur PATH-Variablen in Windows hinzufügen, bevor Sie den Befehl ausführen. Klicken Sie in Windows mit der rechten Maustaste auf Arbeitsplatz. Klicken Sie auf Eigenschaften, dann auf die Registerkarte Erweitert und anschließend auf die Schaltfläche Umgebungsvariablen. Doppelklicken Sie in der Liste Systemvariablen auf die Path-Variable. Fügen Sie in dem Textfeld Variablenwert ein Semikolon (;) hinter die im Textfeld vorhandenen Werte ein, und geben Sie dann den Pfad Ihrer .NET Framework-Installation ein. .NET Framework wird normalerweise im Windows-Installationsordner unter \Microsoft.NET\Framework\Versionsnummer installiert.

Führen Sie den Kompilierungsbefehl in Schritt 4 immer dann aus, wenn Sie neue Quelldateien in den Quellcodeordner einfügen bzw. vorhandene Quelldateien ändern.

Erstellen einer ASP.NET-Website

So erstellen Sie die ASP.NET-Website

Erstellen Sie eine ASP.NET-Website mithilfe der Internetinformationsdienste (IIS) oder einem anderen Tool.
Informationen zur Erstellung und Konfiguration eines virtuellen IIS-Verzeichnisses finden Sie unter Gewusst wie: Erstellen und Konfigurieren von virtuellen Verzeichnissen in IIS 5.0 und 6.0.

Hinweis:

Wenn Sie IIS verwenden möchten, installieren Sie IIS vor der Installation von .NET Framework.
Erstellen Sie einen Ordner mit dem Namen "Bin" unter dem Stammordner der Website.

Hinweis:
Wenn Sie IIS verwenden möchten, installieren Sie IIS vor der Installation von .NET Framework.

Kopieren Sie die Assembly, die Sie in der vorangegangenen Prozedur erstellt haben, in den Ordner Bin der Website.

Hinweis:
Wenn Sie die Steuerelementassembly erneut kompilieren (siehe letzter Schritt im vorhergehenden Abschnitt), müssen Sie die neue Assembly erneut in den Ordner Bin der Website kopieren.

Erstellen Sie eine Textdatei mit dem Namen Web.config im Stammordner der Website, fügen Sie den folgenden XML-Code in die Datei Web.config ein, und speichern Sie dann die Datei.

<?xml version="1.0"?>
<configuration>
  <system.web>
    <compilation debug="true"/>
    <pages>
      <controls>
        <add tagPrefix="aspSample" 
          namespace="Samples.AspNet.CS.Controls" 
          assembly="Samples.AspNet.CS.Controls" >
        </add>
      </controls>
    </pages>
  </system.web>
</configuration>

<?xml version="1.0"?>
<configuration>
  <system.web>
    <compilation debug="true"/>
    <pages>
      <controls>
        <add tagPrefix="aspSample" 
          namespace="Samples.AspNet.VB.Controls" 
          assembly="Samples.AspNet.VB.Controls" >
        </add>
      </controls>
    </pages>
  </system.web>
</configuration>

Fügen Sie dem Stammordner der Website für jedes Beispiel, das Sie testen möchten, eine Textdatei mit einer ASPX-Erweiterung hinzu.

Erstellen Sie z. B. eine Datei mit dem Namen MailLinkTest.aspx für die Testseite des MailLink-Steuerelements, das in dem Beispiel für das Rendering eines Webserversteuerelements zur Verfügung steht.
Kopieren und fügen Sie den Quellcode für jede Beispieltestseite in die entsprechende ASPX-Datei ein, und speichern Sie die Datei.
Fordern Sie die ASPX-Seiten in einem Webbrowser an.

Wenn Ihre Website z. B. ServerControls heißt und eine Seite mit dem Namen MailLinkTest.aspx beinhaltet, geben Sie den folgenden URL in die Adressleiste Ihres Browsers ein:
```
https://localhost/ServerControls/MailLinkTest.aspx
```

Verwenden des Ordners App_Code für das Testen von Steuerelementen

Sie können das dynamische Kompilierungsfeature von ASP.NET 2.0 zum Testen von Steuerelementen verwenden, ohne die Steuerelemente manuell in eine Assembly kompilieren zu müssen.

So legen Sie Steuerelemente im Ordner App_Code ab

Erstellen Sie einen Ordner App_Code unter dem Stammordner der Website.
Kopieren Sie die Quelldateien für die Steuerelemente und die zugehörigen Klassen in den Ordner App_Code.

Wenn Sie in den Ordner Bin zuvor eine Assembly für das Steuerelement hinzugefügt haben, löschen Sie sie.

Hinweis:
Sie können entweder ein Steuerelement in eine Assembly vorkompilieren und die Assembly in den Ordner Bin einfügen oder die Quelldatei des Steuerelements in den Ordner App_Code einfügen. Wenn Sie das Steuerelement in beide Ordner einfügen, kann der Seitenparser einen Verweis auf das Steuerelement der Seite nicht auflösen und generiert einen Fehler.

Ändern Sie in der Datei Web.config den Eintrag unter dem controls-Abschnitt in den folgenden hervorgehobenen Eintrag, der den Namespace des Steuerelements einem Tagpräfix zuordnet:
```
<controls>
  <add tagPrefix="aspSample"     namespace="Samples.AspNet.CS.Controls">..</add>
</controls>
```
```
<controls>
  <add tagPrefix="aspSample"     namespace="Samples.AspNet.VB.Controls">..</add>
</controls>
```
Weitere Informationen finden Sie unter @ Register.
Fordern Sie die ASPX-Seiten in einem Webbrowser an.

Wenn Sie die Quelldatei für die QuickContacts-Klasse und die ContactCollectionEditor-Klasse aus dem Beispiel für eine Auflistungseigenschaft eines Webserversteuerelements in den Ordner App_Code einfügen, müssen Sie auch einen Verweis auf die System.Design-Assembly in dem compilation-Abschnitt der Datei Web.config hinzufügen. Dieser Verweis erfordert den vollqualifizierten Assemblynamen der System.Design-Assembly. Sie können die Informationen für den vollqualifizierten Assemblynamen abrufen, indem Sie das mit dem Windows Software Development Kit (SDK) bereitgestellte Global Assembly Cache-Tool (Gacutil.exe) ausführen. Verwenden Sie dazu die folgende Syntax:

gacutil /l System.Design

Hinweis:
Um das Global Assembly Cache-Tool (Gacutil.exe) über die Befehlszeile auszuführen, muss die PATH-Umgebungsvariable in Windows auf Ihrem Computer den Pfad zur .NET Framework-Installation beinhalten. Klicken Sie in Windows mit der rechten Maustaste auf Arbeitsplatz. Klicken Sie auf Eigenschaften, dann auf die Registerkarte Erweitert und anschließend auf die Schaltfläche Umgebungsvariablen. Doppelklicken Sie in der Liste Systemvariablen auf die Path-Variable. Fügen Sie in dem Textfeld Variablenwert ein Semikolon (;) hinter die im Textfeld vorhandenen Werte ein, und geben Sie dann den Pfad Ihrer .NET Framework-Installation ein. .NET Framework wird normalerweise im Windows-Installationsordner unter \Microsoft.NET\Framework\Versionsnummer installiert.

Um das Global Assembly Cache-Tool (Gacutil.exe) über die Befehlszeile auszuführen, muss die PATH-Umgebungsvariable in Windows auf Ihrem Computer den Pfad zur .NET Framework-Installation beinhalten. Klicken Sie in Windows mit der rechten Maustaste auf Arbeitsplatz. Klicken Sie auf Eigenschaften, dann auf die Registerkarte Erweitert und anschließend auf die Schaltfläche Umgebungsvariablen. Doppelklicken Sie in der Liste Systemvariablen auf die Path-Variable. Fügen Sie in dem Textfeld Variablenwert ein Semikolon (;) hinter die im Textfeld vorhandenen Werte ein, und geben Sie dann den Pfad Ihrer .NET Framework-Installation ein. .NET Framework wird normalerweise im Windows-Installationsordner unter \Microsoft.NET\Framework\Versionsnummer installiert.

Das Tag, das Sie im compilation-Abschnitt der Datei Web.config hinzufügen, ähnelt dem hervorgehobenem Abschnitt im folgenden Beispiel. Sie müssen jedoch die Werte des Version-Attributs und des PublicKeyToken-Attributs mit den Werten ersetzen, die von dem Tool Gacutil.exe zurückgegeben werden.

<compilation >
  <assemblies>    <add assembly="System.Design, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />    </assemblies>
</compilation>

Hinweis:
Wenn Sie eine integrierte Entwicklungsumgebung (IDE) verwenden, kann der Designer eine einfachere Vorgehensweise für das Hinzufügen eines Assemblyverweises zur Datei Web.config bereitstellen. Ein Beispiel aus Visual Studio 2005: Wenn Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Websitenamen und im Kontextmenü auf Verweis hinzufügen klicken, wird ein Dialogfeld angezeigt, in dem Sie eine Assembly, die hinzugefügt werden soll, auswählen können. Wenn Sie die Assembly auswählen, fügt der Designer automatisch den gewünschten Eintrag zur Datei Web.config hinzu.

Wenn Sie eine integrierte Entwicklungsumgebung (IDE) verwenden, kann der Designer eine einfachere Vorgehensweise für das Hinzufügen eines Assemblyverweises zur Datei Web.config bereitstellen. Ein Beispiel aus Visual Studio 2005: Wenn Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Websitenamen und im Kontextmenü auf Verweis hinzufügen klicken, wird ein Dialogfeld angezeigt, in dem Sie eine Assembly, die hinzugefügt werden soll, auswählen können. Wenn Sie die Assembly auswählen, fügt der Designer automatisch den gewünschten Eintrag zur Datei Web.config hinzu.

Siehe auch

Aufgaben

Exemplarische Vorgehensweise: Entwickeln und Verwenden eines benutzerdefinierten Serversteuerelements

Weitere Ressourcen

Entwickeln von benutzerdefinierten ASP.NET-Serversteuerelementen

Sdílet prostřednictvím