Webparts Laden in einem Katalog zur Laufzeit

Willkommen Sie bei ASP.NET Support Voice-Spalte! Ich bin Jerry Orman. Ich haben seit fünf Jahren bei Microsoft und Großteil meiner Zeit konzentriert sich auf webbezogene-Technologien wie Microsoft FrontPage und Microsoft SharePoint-Produkte und-Technologien verbracht haben. Ich habe im vergangene Jahr arbeiten mit Microsoft ASP.NET als einen Supportmitarbeiter aufgewendet wurden.

ASP.NET 2.0 stellt das Webparts-Framework außerhalb der SharePoint-Umgebung. Dadurch können Entwickler Anwendungen erstellen, die zur Laufzeit vom Benutzer konfigurierbar sind. Die-Klasse CatalogPart wird verwendet, um eine Liste der Webparts zur Laufzeit für Benutzer bereitzustellen. Out of Box bietet ASP.NET 2.0 keinen Katalog, der zur Laufzeit aufgefüllt wird. Dieser Support Voice-Kolumne werden zum Erstellen eines benutzerdefinierten Katalogs für diesen Zweck behandelt.

Nicht genügend bietet ASP.NET 2.0 die folgenden Kataloge:

• DeclarativeCatalogPart
  Diese Klasse können Sie zur Entwurfszeit der Webparts-ASPX-Seite deklarativ hinzufügen. Sie können auch WebPartsListUserControlPath -Eigenschaft und zeigen Sie auf ein Benutzersteuerelement (ASCX), die Webparts, die deklarativ zur Entwurfszeit hinzugefügt wurde. Weitere Informationen der folgenden Microsoft Developer Network (MSDN)-Website:
  http://msdn2.microsoft.com/en-us/library/system.web.ui.webcontrols.webparts.declarativecatalogpart.aspx (http://msdn2.microsoft.com/en-us/library/system.web.ui.webcontrols.webparts.declarativecatalogpart.aspx)
• PageCatalogPart
  Diese Klasse zeigt Webparts, die von einem Benutzer geschlossen wurden. Weitere Informationen der folgenden MSDN-Website:
  http://msdn2.microsoft.com/en-us/library/system.web.ui.webcontrols.webparts.pagecatalogpart.aspx (http://msdn2.microsoft.com/en-us/library/system.web.ui.webcontrols.webparts.pagecatalogpart.aspx)
• ImportCatalogPart
  Diese Klasse können Sie einen Webpart importieren, die Sie exportiert haben. Exportieren eines Webparts können Sie die Einstellungen beizubehalten, eignet sich für extrem angepasste Webparts. Weitere Informationen der folgenden MSDN-Website:
  http://msdn2.microsoft.com/en-us/library/system.web.ui.webcontrols.webparts.importcatalogpart.aspx (http://msdn2.microsoft.com/en-us/library/system.web.ui.webcontrols.webparts.importcatalogpart.aspx)

Wie Sie sehen können, also gibt es nichts out of Box, mit denen Sie DLLs in einem Ordner ablegen und diese als Webparts zur Laufzeit ausgewählt werden kann. Zu diesem Zweck müssen Sie eine benutzerdefinierte CatalogPart -Klasse erstellen und überschreiben Sie die folgenden Methoden:

• GetAvailableWebPartDescriptions
  Diese Methode gibt die Webpart-Beschreibungen verwendet, um den Katalog in CatalogZone aufzufüllen. In diesem Beispiel verwenden wir Reflektion in dieser Methode zum Laden der DLLs und bestimmen, ob Sie Webparts enthalten. Weitere Informationen der folgenden MSDN-Website:
  http://msdn2.microsoft.com/en-us/library/system.web.ui.webcontrols.webparts.catalogpart.getavailablewebpartdescriptions.aspx (http://msdn2.microsoft.com/en-us/library/system.web.ui.webcontrols.webparts.catalogpart.getavailablewebpartdescriptions.aspx)
• GetWebPart
  Diese Methode gibt die eigentlichen Webparts auf der Seite wiedergegeben werden soll. Wenn Sie nicht behandeln, Auffüllen der Auflistung, die das Webpart korrekt zurückgibt, Ihren Katalog Rendern und die Beschreibungen angezeigt wird, aber Hinzufügen eines Webparts zu einer WebPartZone wird nichts. Weitere Informationen der folgenden MSDN-Website:
  http://msdn2.microsoft.com/en-us/library/system.web.ui.webcontrols.webparts.catalogpart.getwebpart.aspx (http://msdn2.microsoft.com/en-us/library/system.web.ui.webcontrols.webparts.catalogpart.getwebpart.aspx)

Das folgende Beispiel veranschaulicht einen benutzerdefinierten Katalog erstellen, der Reflektion, verwendet um die Liste der Webparts zur Laufzeit zu füllen. In diesem Beispiel wird als bereitgestellt - ist und sollte nur zu Demonstrationszwecken. Die folgende Datei steht im Microsoft Download Center zum Download zur Verfügung:

Download the CustomCatalogSample.exe package now. (http://download.microsoft.com/download/c/8/0/c8034014-ab56-42b5-bd8e-d2d49c2d0dca/customcatalogsample.exe)

Weitere Informationen zum Microsoft Support-Dateien herunterladen finden Sie im folgenden Artikel der Microsoft Knowledge Base: Microsoft hat diese Datei auf Viren überprüft. Microsoft hat dazu die neueste Software zur Virenerkennung verwendet, die zum Zeitpunkt der Bereitstellung verfügbar war. Die Datei wird auf Servern mit verstärkter Sicherheit gespeichert, nicht autorisierte Änderungen an der Datei verhindert.

Wir werden durch die Beispielprojekte alle nötig sind damit Sie eine Vorstellung davon, was Sie in erhalten abrufen können. Der Code ist vollständig kommentiert, die für einige hervorragende lesen sollten.

Das Beispiel enthält drei Projekte:

• MyControls Klasse Projekt
  • ReflectionCatalogPart
    Dies ist die Klasse, die die Arbeit für den Katalog.
• SampleWebParts-Klasse Projekt
  • RSSPart.cs
    Dies ist ein Webpart ich geschrieben habe, die wechseln und rufen Daten aus einer RSS2 feed. Dies konnte mehr zum Hinzufügen von verschiedenen Vorlagen und Zwischenspeicherung entwickeln werden.
  • FeaturedProductPart.cs, ICategoryInterface.cs und SelectCategory.cs
    Diese sind im folgenden MSDN-Artikel:
    http://msdn2.microsoft.com/en-us/library/ms379628(VS.80).aspx (http://msdn2.microsoft.com/en-us/library/ms379628(VS.80).aspx)
    Ich enthalten Sie hier, um die Liste der Web entwickeln WebParts.
• CustomParts-Website
  • Default.aspx
    Diese Datei Laufwerke im Beispiel. Es verfügt über alle verschiedenen Katalogen und Teile, die bereits auf der Seite deklariert.
  MyControls
  • CatalogTemplate.ascx
    Diese Datei wird in der WebPartsListUserControlPath -Eigenschaft des DeclarativeCatalogPart -Klasse verwendet, um die Verwendung der Eigenschaft zu veranschaulichen.
  • ReportGenerator.ascx
    Diese Datei hat ein GridView -Steuerelement anzuzeigenden mithilfe einer ASCX-Datei als Webpart. (Jedes Steuerelement, das kein Webpart ist ist in der Klasse GenericWebPart umgebrochen, wenn es in einer WebPartZone eingefügt wird.)
  
  

Gehen Sie folgendermaßen vor um das Beispiel zu verwenden:

1. Öffnen Sie die CustomParts-Website als Datei-basierte Projekt in Microsoft Visual Studio 2005.
2. Fügen Sie das MyControls Klasse Projekt und die SampleWebParts-Klasse Projekt als Projekte der Projektmappe. Dazu klicken Sie auf Datei , klicken Sie auf Hinzufügen, und klicken Sie dann auf Vorhandenes Projekt .
3. Erweitern Sie die Website CustomParts .
4. Doppelklicken Sie auf die Web.config-Datei.
5. Ändern Sie die Verbindungszeichenfolge, auf die Instanz von Microsoft SQL Server mit der Nordwind-Datenbank.
6. Durchsuchen Sie die Datei default.aspx.
7. Klicken Sie auf Anmelden .
8. Melden Sie sich durch Eingabe von BobSmith und das Kennwort BobSmith! .
9. Klicken Sie im Menü Webparts bearbeiten auf Katalog .
   
   Sie haben zwei Kataloge, Reflektion Webparts -Katalog und der Deklarative Webparts -Katalog.

Zeigen Sie die ReflectionCatalogPart.cs-Datei in die MyControls -Klasse und dem Asp: CatalogZone -Abschnitt in der Datei default.aspx, um der benutzerdefinierte Katalog Funktionsweise. Im Allgemeinen überprüft bestimmen, ob ein HttpContext und dann verwendet Reflektion, um füllen und Zwischenspeichern der Webparts, die in den/bin-Ordner verfügbar sind. Sie können Webparts hinzufügen, indem Sie die DLL in den/bin-Ordner. Dadurch wird eine Wiederverwendung AppDomain Löschen des Zwischenspeichers und ermöglichen es beim nächsten laden Auffüllen des Katalogs wird ausgelöst.

Nun, da Sie ein Beispiel demonstriert, wie mithilfe von Reflektion Katalog auffüllen haben, können Sie hier, um Kataloge erstellen, die Ihre Bedürfnisse möglicherweise nutzen.

Sie gerne wie immer Ideen auf Themen, die Spalten in Zukunft behandelt werden soll oder in der Knowledge Base mithilfe des Formulars Ask For It (http://support.microsoft.com/common/survey.aspx?scid=sw;en;1176&p0=&p1=&p2=&p3=&p4=) zu senden.