Gewusst wie: Exportieren der Webparts-Steuerelementeinstellungen
Aktualisiert: November 2007
Zur Funktionalität des Webparts-Steuerelementsatzes gehört das Importieren benutzerdefinierter Webparts-Steuerelemente mithilfe des ImportCatalogPart-Steuerelements. Bevor ein Steuerelement jedoch von einem Endbenutzer importiert werden kann, muss es vom Seitenentwickler für den Export verfügbar gemacht werden.
Wenn der Exportvorgang abgeschlossen ist, ist eine Methode zum Importieren des Steuerelements durch den Benutzer erforderlich. Weitere Informationen finden Sie unter Gewusst wie: Importieren von Webparts-Steuerelementeinstellungen durch Benutzer.
So aktivieren Sie ein benutzerdefiniertes Webparts-Steuerelement für den Export
Erstellen Sie eine ASP.NET-Seite, die ein benutzerdefiniertes Webparts-Steuerelement enthält.
Dieses Steuerelement kann entweder von der WebPart-Klasse abgeleitet werden, ein beliebiges geerbtes Steuerelement sein, oder ein Benutzersteuerelement in einer WebPartZone-Zone sein. Weitere Informationen zum Erstellen von Webparts-Seiten finden Sie unter Exemplarische Vorgehensweise: Erstellen einer Webparts-Seite. Ein Beispiel eines benutzerdefinierten Webparts-Steuerelements finden Sie unter WebPart.
.gif "Hinweis")
Hinweis:In der für den Export verwendeten .WebPart-Datei sind ausschließlich Eigenschaften mit dem Personalizable-Attribut enthalten.
Fügen Sie der Datei Web.config im Abschnitt <system.web> ein <webParts>-Element hinzu, bei dem enableExport auf true festgelegt ist, wie im folgenden Beispiel beschrieben.
<webParts enableExport="true"></webParts>Legen Sie die ExportMode-Eigenschaft des Steuerelements auf Alle fest. Wenn das Steuerelement von WebPart abgeleitet ist, können Sie dies in Markup durchführen, wie im folgenden Beispiel gezeigt wird.
<aspSample:CustomWebPart id="Sample" ExportMode="All" />Wenn Sie kein geerbtesWebPart-Steuerelement verwenden, jedoch ein anderes Steuerelement innerhalb einer WebPartZone-Zone, müssen Sie die you must set theExportMode-Eigenschaft des enthaltenden GenericWebPart-Steuerelements im Code festlegen, wie im folgenden Beispielabschnitt gezeigt wird.
Laden Sie die Webseite in einem Browser, und klicken Sie im Verbenmenü des WebPart-Steuerelements auf Verben exportieren. Folgen Sie den Anweisungen, um eine Beschreibungsdatei zu exportieren, die Daten über den Zustand und die Eigenschaften des Steuerelements enthält.
Beispiel
Um ein Steuerelement zu exportieren, das nicht von der WebPart-Klasse erbt, muss das Steuerelement zunächst innerhalb einer WebPartZone-Zone auf der Seite platziert werden. Dadurch wird das Steuerelement automatisch in ein GenericWebPart-Steuerelement eingebunden, auf welches Sie über Code zugreifen können, um die ExportMode-Eigenschaft während des Page_Load()-Ereignisses festzulegen. Im folgenden Beispiel ist Control1 der Name des zu exportierenden Steuerelements.
Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load
Dim gwp As GenericWebPart
gwp = Control1.Parent
gwp.ExportMode = WebPartExportMode.All
End Sub
protected void Page_Load(object sender, EventArgs e)
{
GenericWebPart gwp = (GenericWebPart) Control1.Parent;
gwp.ExportMode = WebPartExportMode.All;
}
Siehe auch
Aufgaben
Gewusst wie: Behandeln eines Benutzersteuerelements als Webparts-Steuerelement
Gewusst wie: Importieren von Webparts-Steuerelementeinstellungen durch Benutzer
Gewusst wie: Importieren von Webparts-Steuerelementeinstellungen durch Benutzer
Referenz
System.Web.UI.WebControls.WebParts