BaseDataList-Klasse

Artikel
08/20/2007

Fungiert als abstrakte Basisklasse für Datenauflistungssteuerelemente, z. B. DataList und DataGrid. Diese Klasse stellt die allen Datenauflistungssteuerelementen gemeinsamen Methoden und Eigenschaften bereit.

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

Syntax

'Declaration
Public MustInherit Class BaseDataList
    Inherits WebControl
'Usage
Dim instance As BaseDataList

public abstract class BaseDataList : WebControl

public ref class BaseDataList abstract : public WebControl

public abstract class BaseDataList extends WebControl

public abstract class BaseDataList extends WebControl

Hinweise

Die BaseDataList-Klasse stellt gemeinsame Funktionen für alle Datenauflistungssteuerelemente bereit, z. B für DataList und DataGrid. Mit Datenauflistungssteuerelementen werden die Datensätze einer Datenquelle angezeigt, z. B. ein System.Data.DataView-Steuerelement. Jedes Datenauflistungssteuerelement kann seinen eigenen Anzeigestil und eigene Funktionen besitzen. Da die BaseDataList-Klasse abstrakt ist, wird eine Instanz dieser Klasse nicht direkt erstellt. Stattdessen erben Datenauflistungssteuerelemente die Methoden und Eigenschaften, die allen Datenauflistungssteuerelementen dieser Klasse gemeinsam sind.

Die Darstellung eines Datenauflistungssteuerelements kann durch Festlegen bestimmter Eigenschaften dieser Klasse gesteuert werden. Legen Sie die CellSpacing-Eigenschaft fest, um den Abstand zwischen den Zellen eines Datenauflistungssteuerelements zu bestimmen. Wenn die Abstände zwischen dem Inhalt und dem Rahmen einer Zelle bestimmt werden sollen, legen Sie die CellPadding-Eigenschaft fest. Sie können die Rahmen zwischen den einzelnen Zellen eines Datenauflistungssteuerelements anzeigen, indem Sie die GridLines-Eigenschaft festlegen. Die horizontale Ausrichtung des Zelleninhalts eines Datenauflistungssteuerelements wird mithilfe der HorizontalAlign-Eigenschaft gesteuert.

Die BaseDataList-Klasse stellt zur Unterstützung der Datenbindung zwei Eigenschaften bereit. Wenn Sie Daten an ein beliebiges Objekt binden möchten, das die System.Collections.IEnumerable-Schnittstelle implementiert (z. B. System.Data.DataView, System.Collections.ArrayList und System.Collections.Hashtable) oder die IListSource-Schnittstelle, geben Sie mit der DataSource-Eigenschaft die Datenquelle an. Wenn Sie die DataSource-Eigenschaft festlegen, müssen Sie den Code zum Durchführen der Datenbindung manuell schreiben. Verwenden Sie zum automatischen Binden eines Datenauflistungssteuerelements an eine durch ein Datenquellen-Steuerelement dargestellte Datenquelle die DataSourceID-Eigenschaft, und legen Sie ihren Wert auf die ID-Eigenschaft des zu verwendenden Datenquellen-Steuerelements fest. Wenn Sie die DataSourceID-Eigenschaft festlegen, wird das Datenlistensteuerelement automatisch an das angegebene Datenquellen-Steuerelement gebunden. Daher müssen Sie die DataBind-Methode nicht explizit aufrufen.

Wenn die von der DataSource-Eigenschaft angegebene Datenquelle mehrere Datenquellen enthält, geben Sie mithilfe der DataMember-Eigenschaft die bestimmte Quelle an, die an das Steuerelement gebunden werden soll. Bei einem System.Data.DataSet-Objekt mit mehreren Tabellen müssen Sie z. B. angeben, welche Tabelle an das Steuerelement gebunden werden soll. Nachdem Sie die Datenquelle angegeben haben, binden Sie diese mithilfe der DataBind-Methode an das Steuerelement.

Die BaseDataList-Klasse enthält eine DataKeys-Auflistung, in der das Schlüsselfeld jedes Datensatzes gespeichert ist, das in einem Datenauflistungssteuerelement als Zeile angezeigt wird. Dadurch können Sie das Schlüsselfeld mit einem Datenauflistungssteuerelement speichern, ohne es im Steuerelement anzuzeigen. Das Schlüsselfeld wird normalerweise als Teil einer Abfragezeichenfolge zum Aktualisieren verwendet, um einen bestimmten Datensatz in der Datenquelle zu bearbeiten. Die Auflistung wird mit den Werten aus dem von der DataKeyField-Eigenschaft angegebenen Feld gefüllt.

Die BaseDataList-Klasse stellt ein SelectedIndexChanged-Ereignis bereit, das ausgelöst wird, wenn das im Steuerelement ausgewählte Element geändert wird. Auf diese Weise können Sie einen benutzerdefinierten Ereignishandler erstellen, der beim Auslösen des Ereignisses eine bestimmte Gruppe von Anweisungen ausführt.

Hinweise für Erben Beim Erben von BaseDataList müssen Sie die folgenden Member überschreiben: CreateControlHierarchy und PrepareControlHierarchy.

.NET Framework-Sicherheit

AspNetHostingPermission für den Betrieb in einer Hostumgebung. Anforderungswert: LinkDemand, Berechtigungswert: Minimal
AspNetHostingPermission für den Betrieb in einer Hostumgebung. Anforderungswert: InheritanceDemand, Berechtigungswert: Minimal

Vererbungshierarchie

System.Object
   System.Web.UI.Control
     System.Web.UI.WebControls.WebControl
      System.Web.UI.WebControls.BaseDataList
         System.Web.UI.WebControls.DataGrid
         System.Web.UI.WebControls.DataList

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

BaseDataList-Member
System.Web.UI.WebControls-Namespace
DataGrid
DataList
CellSpacing
CellPadding
GridLines
HorizontalAlign
DataSource
DataMember
DataBind
DataKeys
DataKeyField
SelectedIndexChanged
System.Collections.IEnumerable
System.Data.DataView
System.Collections.ArrayList
System.Collections.Hashtable
System.Data.DataSet

Freigeben über