BaseDataList.DataSourceID Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Ruft die ID-Eigenschaft des Datenquellen-Steuerelements ab, von dem das Datenauflistungssteuerelement seine Datenquelle abrufen soll, oder legt diese Eigenschaft fest.

public:
 virtual property System::String ^ DataSourceID { System::String ^ get(); void set(System::String ^ value); };

[System.Web.UI.Themeable(false)]
public virtual string DataSourceID { get; set; }

[<System.Web.UI.Themeable(false)>]
member this.DataSourceID : string with get, set

Public Overridable Property DataSourceID As String

Eigenschaftswert

String

Der programmgesteuerte Bezeichner, der dem Datenquellen-Steuerelement zugewiesen ist.

Attribute

ThemeableAttribute

Ausnahmen

HttpException

Die Datenquelle kann nicht aufgelöst werden, weil sowohl für die DataSource-Eigenschaft als auch für die DataSourceID-Eigenschaft ein Wert angegeben wurde.

Hinweise

Verwenden Sie die DataSourceID -Eigenschaft, um auf die ID Eigenschaft des Datenquellensteuerelements zuzugreifen, das das Datenauflistungssteuerelement verwenden soll, um seine Datenquelle abzurufen. Das Datenquellensteuerelement, auf das von der DataSourceID -Eigenschaft verwiesen wird, kann ein beliebiges Steuerelement sein, das die IDataSource -Schnittstelle implementiert. Das Datenquellensteuerelement muss entweder im gleichen Namenscontainer wie das Datenauflistungssteuerelement, das darauf verweist, oder in einem übergeordneten Steuerelement des Datenauflistungssteuerelements vorhanden sein. Wenn Sie einen Wert für diese Eigenschaft angeben, wird das Datenauflistungssteuerelement automatisch an das angegebene Datenquellensteuerelement gebunden. Sie müssen keinen Code schreiben, der die DataBind -Methode explizit aufruft.

Alternativ können Sie die DataSource -Eigenschaft verwenden, um die Quelle der Werte anzugeben, die an ein Datenauflistungssteuerelement gebunden werden sollen. Die Datenquelle muss eine Auflistung sein, die die System.Collections.IEnumerable -Schnittstelle (z System.Data.DataView. B. , System.Collections.ArrayListoder System.Collections.Generic.List<T>) oder die Schnittstelle implementiert, die IListSource an ein von der BaseDataList -Klasse abgeleitetes Steuerelement gebunden werden soll. Wenn Sie die DataSource -Eigenschaft festlegen, müssen Sie den Code manuell schreiben, um die Datenbindung auszuführen.

Wenn Werte sowohl für die DataSource -Eigenschaft als auch für die DataSourceID -Eigenschaft angegeben werden, kann ASP.NET die Datenquelle nicht auflösen, und es wird eine System.Web.HttpException Ausnahme ausgelöst.

Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und ASP.NET-Designs und Skins.

Weitere Informationen

• DataSource