Erstellen eines datengebundenen Webparts-Steuerelements
Aktualisiert: November 2007
Durch Erben von der WebPart-Basisklasse können Sie einem gewöhnlichen datengebundenen Serversteuerelement Webparts-Funktionen geben. In Webparts-Anwendungen können Endbenutzer das Verhalten und die Benutzeroberfläche von Serversteuerelementen verändern (personalisieren) und die Einstellungen in einem Langzeitspeicher für zukünftige Browsersitzungen speichern. Benutzer können das Aussehen und Verhalten einer Seite deutlich verändern, indem sie Steuerelemente hinzufügen oder entfernen, die Eigenschaften und das Erscheinungsbild von Steuerelementen bearbeiten, das Seitenlayout verändern, Einstellungen für die Steuerelemente importieren oder exportieren und Verbindungen herstellen, über die Steuerelemente Daten gemeinsam verwenden können. Weitere Informationen zu Webparts-Anwendungen finden Sie in den in ASP.NET-Webparts-Steuerelemente aufgelisteten Themen. In diesem Thema werden die Voraussetzungen zum Verwenden eines benutzerdefinierten, datengebundenen WebPart-Steuerelements (oder eines beliebigen Serversteuerelements) in einer Webparts-Anwendung beschrieben. Außerdem enthält das Thema zusammenfassende Informationen zu einigen Membern der WebPart-Basisklasse, die zum Implementieren oder Überschreiben eines benutzerdefinierten Steuerelements hilfreich sind. Ein Beispiel für das Überschreiben und Implementieren einiger dieser Member finden Sie im Thema Beispiel für ein datengebundenes Webparts-Steuerelement.
Zur Verwendung eines Webparts-Steuerelements erforderliche Elemente
Kein Webparts-Steuerelement kann isoliert ausgeführt werden und dabei die Webparts-Features beibehalten. Wenn ein WebPart-Steuerelement in einer Webanwendung ohne andere für eine Webparts-Anwendung erforderliche Elemente ausgeführt wird, verliert das Steuerelement die Webparts-Features und funktioniert wie ein gewöhnliches Serversteuerelement. In der folgenden Liste werden die erforderlichen Elemente erläutert, die positioniert werden müssen, bevor Sie ein benutzerdefiniertes WebPart-Steuerelement mit Webparts-Features verwenden können:
Das WebPartManager-Steuerelement. Dieses Steuerelement muss auf jeder Seite vorhanden sein, die Webparts-Funktionen enthält. Weitere Informationen finden Sie unter Übersicht über die Gruppe der Webparts-Steuerelemente.
Ein WebPartZoneBase-Zonensteuerelement. Eine Webseite muss eine Zone enthalten, die von dieser abstrakten Klasse abgeleitet wird, z. B. das WebPartZone-Steuerelement, um WebPart-Steuerelemente enthalten zu können. Weitere Informationen finden Sie unter Übersicht über die Gruppe der Webparts-Steuerelemente.
Eine ASP.NET Website, die einzelne Benutzer mithilfe von Windows- oder Formularauthentifizierung erkennen kann. Ausführliche Informationen über das Erstellen eines virtuellen Verzeichnisses oder einer virtuellen Site finden Sie unter Gewusst wie: Erstellen und Konfigurieren von virtuellen Verzeichnissen in IIS 5.0 und 6.0 oder Gewusst wie: Erstellen und Konfigurieren von lokalen ASP.NET-Websites in IIS 6.0.
Ein konfigurierter Personalisierungsanbieter und eine konfigurierte Personalisierungsdatenbank, in der Benutzereinstellungen für Steuerelemente gespeichert werden. Die Webparts-Personalisierung ist in der Standardeinstellung aktiviert und verwendet den SQL-Personalisierungsanbieter (SqlPersonalizationProvider) mit der Microsoft SQL Server Express Edition (SSE) zum Speichern von Personalisierungsdaten. In dieser exemplarischen Vorgehensweise werden SSE und der SQL-Standardanbieter verwendet. Wenn Sie SSE installiert haben, wird keine Konfiguration benötigt. SSE ist in Verbindung mit Microsoft Visual Studio 2005 als optionale Installationskomponente erhältlich oder kann kostenlos unter Microsoft.com gedownloadet werden. Das Verwenden einer Vollversion von Microsoft SQL Server erfordert das Installieren und Konfigurieren einer Datenbank für ASP.NET-Anwendungsdienste sowie das Konfigurieren des SQL-Personalisierungsanbieters zum Herstellen einer Verbindung mit der Datenbank. Weitere Informationen finden Sie unter Erstellen und Konfigurieren der Datenbank für die Anwendungsdienste für SQL Server. Sie können auch einen benutzerdefinierten Anbieter erstellen und konfigurieren, der mit anderen, Nicht-SQL-Datenbanken oder Speicherlösungen verwendet wird. Ausführliche Informationen und ein Codebeispiel finden Sie unter Implementieren eines Mitgliedschaftsanbieters.
Häufig überschriebene oder verwendete Webparts-Member
Obwohl jeder Typ von Serversteuerelement in Webparts-Anwendungen verwendet werden kann, hat das Erstellen von benutzerdefinierten WebPart-Steuerelementen einige Vorteile (genauere Informationen finden Sie unter Verwenden von ASP.NET-Serversteuerelementen in Webparts-Anwendungen). Wenn von der WebPart-Basisklasse geerbt wird, ist es nicht erforderlich, bestimmte Member zu implementieren. Es gibt jedoch einige häufig verwendete Member, die Sie möglicherweise verwenden oder überschreiben möchten. Diese sind in der folgenden Tabelle zusammengefasst. Ein vollständiges Beispiel für ein datengebundenes Serversteuerelement, das als WebPart-Steuerelement implementiert ist, finden Sie unter Beispiel für ein datengebundenes Webparts-Steuerelement. In der folgenden Tabelle werden einige häufig verwendete Member beschrieben.
Member |
Beschreibung |
|---|---|
WebPart |
Mit diesem Konstruktor werden häufig Standardwerte für einige der Eigenschaften festgelegt, die das Aussehen und Verhalten eines WebPart-Steuerelements bestimmen, z. B. die von der Part-Klasse geerbten Eigenschaften, oder Verhaltenseigenschaften, z. B. die AllowEdit-Eigenschaft und die AllowLayoutChange-Eigenschaft. |
Verhaltenseigenschaften |
Dies umfasst einige "Allow"-Eigenschaften der Klasse, z. B. AllowClose, AllowConnect, AllowEdit, AllowMinimize, AllowLayoutChange und AllowZoneChange. Anstatt diesen Eigenschaften einfach Standardwerte im Konstruktor zuzuweisen, können Entwickler eine Eigenschaft vollständig steuern. Dies geschieht z. B indem verhindert wird, dass Benutzer oder Entwickler, die das Steuerelement verwenden, das Steuerelement schließen können. |
Wenn von der WebPart-Klasse geerbt wird, müssen Sie für das benutzerdefinierte Steuerelement eine Benutzeroberfläche bereitstellen. Eine sehr effektive Möglichkeit hierzu besteht darin, die CreateChildControls-Methode zu überschreiben und in dieser Methode andere Serversteuerelemente hinzuzufügen, die die Benutzeroberfläche des benutzerdefinierten Steuerelements darstellen. Sie müssen möglicherweise zusätzliche Aufgaben beim Hinzufügen dieser Steuerelemente ausführen, z. B. benutzerdefinierte Ereignishandler für diese Steuerelemente erstellen oder die Steuerelemente an eine Datenquelle binden. |
|
Darstellungsmethoden |
Sie müssen möglicherweise häufig verwendete Darstellungsmethoden überschreiben, z. B. RenderControl oder RenderContents. In diesen Methoden können Sie entweder die Wiedergabe vollständig überschreiben, oder Sie rufen zuerst die Basismethode auf und verändern dann einige Aspekte der Wiedergabe. |
Wenn Sie benutzerdefinierte WebPartVerb-Objekte erstellen, die in Verbenmenüs des Steuerelements mit den Standardverben angezeigt werden (z. B. Schließen und Minimieren), müssen Sie diese der Verbs-Auflistung des Steuerelements hinzufügen. |
|
Wenn Sie benutzerdefinierte EditorPart-Steuerelemente erstellen, mit denen Benutzer die benutzerdefinierten Eigenschaften des Steuerelements bearbeiten können, müssen Sie diese durch Überschreiben der CreateEditorParts-Methode dem Steuerelement zuordnen. Ein Beispiel finden Sie unter der Beschreibung der IWebEditable-Schnittstelle. |
|
Wenn Sie benutzerdefinierte Eigenschaften im WebPart-Steuerelement erstellen, sollen Benutzer häufig diese Eigenschaften bearbeiten und anpassen können, genau wie die Standard-WebPart-Steuerelementeigenschaften, damit die Einstellungen gespeichert werden können. Fügen Sie jeder Eigenschaft, die der Benutzer personalisieren können soll, das Personalizable-Metadatenattribut hinzu. |
Beispiel für ein datengebundenes Webparts-Steuerelement
Ein vollständiges Codebeispiel, in dem das Erstellen eines GridView-Steuerelements veranschaulicht wird, das an die Northwind-Datenbank gebunden ist und das Steuerelement als ein WebPart-Steuerelement implementiert, finden Sie unter Beispiel für ein datengebundenes Webparts-Steuerelement.
Siehe auch
Aufgaben
Exemplarische Vorgehensweise: Erstellen einer Webparts-Seite
Konzepte
Übersicht über ASP.NET-Webparts