Gewusst wie: Importieren von Webparts-Steuerelementeinstellungen durch Benutzer
Aktualisiert: November 2007
Zur Funktionalität des Webparts-Steuerelementsatzes gehört das Importieren benutzerdefinierter Webparts-Steuerelemente mithilfe des ImportCatalogPart-Steuerelements. Das ImportCatalogPart-Steuerelement lädt eine Beschreibungsdatei. Dabei handelt es sich um eine XML-Datei mit der Erweiterung .WebPart, in der Speicherort und personalisierbare Eigenschaftenwerte des zu importierenden Steuerelements enthalten sind. Wenn ein Benutzer im ImportCatalogPart-Steuerelement auf die Schaltfläche Uploaden klickt, wird das eigentliche Steuerelement vom Webserver geladen. Anschließend kann der Benutzer das importierte Steuerelement der Seite hinzufügen.
Hinweis: |
---|
Das eigentlich zu importierende Steuerelement muss sich auf dem Webserver befinden, der die Seite hostet. |
Weitere Informationen zum Exportieren einer Beschreibungsdatei für das Importieren finden Sie unter Gewusst wie: Exportieren der Webparts-Steuerelementeinstellungen.
So ermöglichen Sie das Importieren für eine Seite
Erstellen Sie eine ASP.NET-Webparts-Seite mit einer CatalogZone-Zone, die wiederum ein ImportCatalogPart-Steuerelement in einer ZoneTemplate-Vorlage enthält. Das Markup für die CatalogZone-Zone sollte der Darstellung im folgenden Beispiel entsprechen.
<asp:CatalogZone id="CZ1" > <ZoneTemplate> <asp:ImportCatalogPart id="ICP1" /> </ZoneTemplate> </asp:CatalogZone>
Hinweis: Die Seite muss ein WebPartManager-Steuerelement enthalten, damit Webparts-Steuerelemente ordnungsgemäß funktionieren. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Erstellen einer Webparts-Seite.
Stellen Sie dem Benutzer eine Funktion zur Verfügung, mit der er die Seitenanzeige in den Katalogmodus schalten kann.
Weitere Informationen zum Einstellen und Wechseln der Seitenanzeigemodi finden Sie unter Gewusst wie: Festlegen des Anzeigemodus einer Webparts-Seite und Exemplarische Vorgehensweise: Wechseln des Anzeigemodus auf einer Webparts-Seite.
So importieren Sie ein Webparts-Steuerelement
Öffnen Sie die Seite in einem Browser, und legen Sie den Katalogmodus als Anzeigemodus fest.
Klicken Sie im ImportCatalogPart-Steuerelement auf die Schaltfläche Durchsuchen.
Wechseln Sie in das Verzeichnis, in dem sich die zu ladende Beschreibungsdatei befindet, und klicken Sie auf Öffnen.
Klicken Sie auf die Schaltfläche Uploaden.
Das Steuerelement wird im ImportCatalogPart-Steuerelement angezeigt.
Ziehen Sie das importierte Steuerelement auf die Seite, und setzen Sie den Seitenanzeigemodus zurück auf den Durchsuchen-Modus.
Siehe auch
Aufgaben
Gewusst wie: Exportieren der Webparts-Steuerelementeinstellungen
Gewusst wie: Festlegen des Anzeigemodus einer Webparts-Seite
Exemplarische Vorgehensweise: Wechseln des Anzeigemodus auf einer Webparts-Seite
Referenz
System.Web.UI.WebControls.WebParts