BaseDataListDesigner-Klasse

Artikel
08/20/2007

Stellt eine Basisklasse für Komponenten bereit, die in einem Designerhost Entwurfszeitunterstützung für Webserversteuerelemente bieten, die von der BaseDataList-Klasse abgeleitet sind.

Namespace: System.Web.UI.Design.WebControls
Assembly: System.Design (in system.design.dll)

Syntax

'Declaration
Public MustInherit Class BaseDataListDesigner
    Inherits TemplatedControlDesigner
    Implements IDataBindingSchemaProvider, IDataSourceProvider
'Usage
Dim instance As BaseDataListDesigner

public abstract class BaseDataListDesigner : TemplatedControlDesigner, IDataBindingSchemaProvider, IDataSourceProvider

public ref class BaseDataListDesigner abstract : public TemplatedControlDesigner, IDataBindingSchemaProvider, IDataSourceProvider

public abstract class BaseDataListDesigner extends TemplatedControlDesigner implements IDataBindingSchemaProvider, IDataSourceProvider

public abstract class BaseDataListDesigner extends TemplatedControlDesigner implements IDataBindingSchemaProvider, IDataSourceProvider

Hinweise

Wenn Benutzer in einem Designerhost von der Quellansicht zur Entwurfsansicht wechseln, wird der Markupquellcode analysiert, der ein von der abstrakten BaseDataList-Klasse abgeleitetes Steuerelement beschreibt, und auf der Entwurfsoberfläche wird eine Entwurfszeitversion des Steuerelements erstellt. Wenn der Benutzer zurück zur Quellansicht wechselt, wird das Entwurfszeit-Steuerelement im Markupquellcode beibehalten und in das Markup für die Webseite eingearbeitet. Die abstrakte BaseDataListDesigner-Klasse fungiert als Basisklasse für Komponenten, die in einem Designerhost Entwurfszeitunterstützung für Steuerelemente bereitstellen, die von BaseDataList abgeleitet sind.

Die BaseDataListDesigner-Klasseneigenschaften bieten folgende Funktionalität:

Die ActionLists-Eigenschaft gibt ein DesignerActionListCollection-Objekt zurück, das üblicherweise ein Objekt enthält, das für jede Ebene in der Vererbungsstruktur des Designers von der DesignerActionList-Klasse abgeleitet wird.

Die DataKeyField-Eigenschaft, die DataMember-Eigenschaft, die DataSource-Eigenschaft und die DataSourceID-Eigenschaft ermöglichen den Zugriff auf die zugehörigen Eigenschaften des zugeordneten Steuerelements.
Die DataSourceDesigner-Eigenschaft ermöglicht den Zugriff auf den Designer der Datenquelle des zugeordneten Steuerelements. Die DesignerView-Eigenschaft ruft die Standardansicht der Datenquelle ab.

Die BaseDataListDesigner-Klassenmethoden bieten folgende Funktionalität:

Die Initialize-Methode bereitet den Designer zum Anzeigen, Bearbeiten und Entwerfen des zugeordneten Steuerelements vor. Die InvokePropertyBuilder-Methode ruft einen Komponenten-Editor für das Steuerelement auf. Die PreFilterProperties-Methode wird verwendet, um Eigenschaften vom zugeordneten Steuerelement zu entfernen, diesem Eigenschaften hinzuzufügen oder Shadowing von Eigenschaften des zugeordneten Steuerelements durchzuführen.
Die GetDesignTimeDataSource-Methode generiert ein Objekt, das zur Entwurfszeit als Datenquelle verwendet werden kann. Die GetSelectedDataSource-Methode ruft die Datenquelle aus dem Container des zugeordneten Steuerelements ab. Die GetResolvedSelectedDataSource-Methode ruft die Datenquelle aus dem Steuerelementcontainer ab, die zu einem bestimmten Datenmember aufgelöst wurde. Die GetTemplateContainerDataSource-Methode ruft die Datenquelle des Vorlagencontainers ab.
Die OnComponentChanged-Methode wird aufgerufen, wenn das zugeordnete Steuerelement geändert wurde. Die OnDataSourceChanged-Methode wird aufgerufen, wenn die Datenquelle des zugeordneten Steuerelements geändert wurde. Die OnSchemaRefreshed-Methode wird aufgerufen, wenn sich das Schema der Datenquelle des zugeordneten Steuerelements ändert. Die OnAutoFormatApplied-Methode wird aufgerufen, wenn ein Schema für die automatische Formatierung angewendet wurde.
Die OnStylesChanged-Methode und die OnTemplateEditingVerbsChanged-Methode können überschrieben werden, um Funktionen zu implementieren, die ausgeführt werden, wenn sich das Format eines zugeordneten Steuerelements geändert hat bzw. wenn sich die Vorlagenbearbeitungsverben des Designers geändert haben. Die OnPropertyBuilder-Methode behandelt das Ereignis des Eigenschaften-Generators.

.NET Framework-Sicherheit

SecurityPermission für die Berechtigung zum Aufrufen von nicht verwaltetem Code. Anforderungswert: Demand. Berechtigungswert: UnmanagedCode

Vererbungshierarchie

System.Object
   System.ComponentModel.Design.ComponentDesigner
     System.Web.UI.Design.HtmlControlDesigner
       System.Web.UI.Design.ControlDesigner
         System.Web.UI.Design.TemplatedControlDesigner
          System.Web.UI.Design.WebControls.BaseDataListDesigner
             System.Web.UI.Design.WebControls.DataGridDesigner
             System.Web.UI.Design.WebControls.DataListDesigner

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

BaseDataListDesigner-Member
System.Web.UI.Design.WebControls-Namespace
BaseDataList
TemplatedControlDesigner-Klasse
ControlDesigner-Klasse

Weitere Ressourcen

Übersicht über ASP.NET-Steuerelement-Designer
Exemplarische Vorgehensweise: Erstellen eines einfachen Steuerelement-Designers für ein Webserver-Steuerelement

Freigeben über