Gewusst wie: Erstellen von personalisierbaren Eigenschaften für ein Webparts-Steuerelement

Aktualisiert: November 2007

Eines der wichtigsten Features des Webparts-Steuerelementsatzes ist die Möglichkeit zum Personalisieren der Steuerelemente auf einer Seite. Dies ermöglicht dem Endbenutzer das Festlegen von Eigenschaftenwerten, die bei jedem Anzeigen der Seite durch diesen Benutzer verwendet werden.

Seitenentwickler können die Personalisierung durch Anwenden des Personalizable-Attributs auf eine öffentliche Eigenschaft eines Webparts-Steuerelements aktivieren. Das Steuerelement kann ein von WebPart geerbtes, benutzerdefiniertes Steuerelement, ein Benutzersteuerelement oder ein beliebiges anderes Steuerelement sein, für das Sie eine Eigenschaft erstellen können. Die einzige Einschränkung ist, dass sich das Steuerelement in einer WebPartZone-Zone befinden und auf der Seite ein WebPartManager-Steuerelement vorhanden sein muss.

Hinweis:

Wenn Sie diese Prozedur verwenden möchten, benötigen Sie eine ASP.NET-Website, die einzelne Benutzer identifizieren kann. Wenn Sie bereits eine solche Site konfiguriert haben, können Sie diese verwenden. Andernfalls finden Sie ausführliche Informationen zum Erstellen eines virtuellen Verzeichnisses unter Gewusst wie: Erstellen und Konfigurieren von virtuellen Verzeichnissen in IIS 5.0 und 6.0. Weiterhin sind ein konfigurierter Personalisierungsanbieter und eine Personalisierungsdatenbank erforderlich. Die Webparts-Personalisierung ist in der Standardeinstellung aktiviert. Wenn Microsoft SQL Server Express (SSE) installiert ist, wird keine Konfiguration benötigt. SSE ist als Option bei der Installation von Microsoft Visual Studio 2005 verfügbar oder kann kostenlos auf Microsoft.com gedownloadet werden. Wenn Sie stattdessen eine Vollversion von SQL Server verwenden, finden Sie Informationen unter Erstellen und Konfigurieren der Datenbank für die Anwendungsdienste für SQL Server. Informationen zu nicht SQL-basierten Datenbanken und Speicherlösungen finden Sie unter Implementieren eines Mitgliedschaftsanbieters.

So aktivieren Sie die Personalisierung eines Steuerelements

1. Platzieren Sie das zu personalisierende Steuerelement in einer WebPartZone-Zone auf einer ASP.NET Webparts-Seite. Die Seite muss ein WebPartManager-Steuerelement enthalten, damit Webparts-Steuerelemente ordnungsgemäß funktionieren. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Erstellen einer Webparts-Seite.

2. Fügen Sie am Anfang des Codeblocks, in dem das zu personalisierende Steuerelement definiert ist, das Personalizable-Attribut hinzu. Dies wird im folgenden Beispiel dargestellt.

   <Personalizable()>
   Property SampleProperty() As String
     Get…
     Set…
   End Property
   

   [Personalizable]
   Public string SampleProperty
   {
     Get{…}
     Set{…}
   }
   

Siehe auch

Konzepte

Übersicht über die Webparts-Personalisierung

Voraussetzungen für die Verwendung der Webparts-Personalisierung

Referenz

System.Web.UI.WebControls.WebParts

Personalizable

Weitere Ressourcen

ASP.NET-Webparts-Steuerelemente

Webparts-Personalisierung