BaseDataList.DataSourceID Eigenschaft

Definition

Ruft die ID-Eigenschaft des Datenquellen-Steuerelements ab, von dem das Datenauflistungssteuerelement seine Datenquelle abrufen soll, oder legt diese Eigenschaft fest.Gets or sets the ID property of the data source control that the data listing control should use to retrieve its data source.

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; }
member this.DataSourceID : string with get, set
Public Overridable Property DataSourceID As String

Eigenschaftswert

Der programmgesteuerte Bezeichner, der dem Datenquellen-Steuerelement zugewiesen ist.The programmatic identifier assigned to the data source control.

Attribute

Ausnahmen

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.The data source cannot be resolved because a value is specified for both the DataSource property and the DataSourceID property.

Hinweise

Verwenden Sie die DataSourceID-Eigenschaft, um auf die ID-Eigenschaft des Datenquellen-Steuer Elements zuzugreifen, mit dem das Daten Auflistungs Steuerelement seine Datenquelle abrufen soll.Use the DataSourceID property to access the ID property of the data source control that the data listing control should use to retrieve its data source. Das Datenquellen Steuerelement, auf das die DataSourceID-Eigenschaft verweist, kann jedes Steuerelement sein, das die IDataSource-Schnittstelle implementiertThe data source control referenced by the DataSourceID property can be any control that implements the IDataSource interface. Das Datenquellen-Steuerelement muss entweder im gleichen Namens Container wie das Daten Auflistungs Steuerelement vorhanden sein, das darauf verweist, oder in einem übergeordneten Steuerelement des Daten Auflistungs Steuer Elements.The data source control must exist either in the same naming container as the data listing control that references it, or in a parent control of the data listing control. Wenn Sie einen Wert für diese Eigenschaft angeben, bindet das Daten Auflistungs Steuerelement automatisch an das angegebene Datenquellen-Steuerelement.When you specify a value for this property, the data listing control automatically binds to the specified data source control. Sie müssen keinen Code schreiben, der explizit die DataBind-Methode aufruft.You do not need to write code that explicitly calls the DataBind method.

Alternativ können Sie die DataSource-Eigenschaft verwenden, um die Quelle der Werte anzugeben, die an ein Daten Auflistungs Steuerelement gebunden werden sollen.Alternately, you can use the DataSource property to specify the source of values to bind to a data listing control. Die Datenquelle muss eine Auflistung sein, die die System.Collections.IEnumerable-Schnittstelle implementiert (z. b. System.Data.DataView, System.Collections.ArrayListoder System.Collections.Generic.List<T>), oder die IListSource Schnittstelle, die an ein von der BaseDataList-Klasse abgeleitetes Steuerelement gebunden werden soll.The data source must be a collection that implements the System.Collections.IEnumerable interface (such as System.Data.DataView, System.Collections.ArrayList, or System.Collections.Generic.List<T>) or the IListSource interface to bind to a control derived from the BaseDataList class. Wenn Sie die DataSource-Eigenschaft festlegen, müssen Sie den Code manuell schreiben, um die Datenbindung auszuführen.When you set the DataSource property, you must manually write the code to perform data binding.

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.If values are specified for both the DataSource property and the DataSourceID property, ASP.NET is not able to resolve the data source and an System.Web.HttpException exception is thrown.

Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden.This property cannot be set by themes or style sheet themes. Weitere Informationen finden Sie unter ThemeableAttribute und ASP.NET-Designs und Skins.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

Gilt für:

Siehe auch