BaseDataList.DataSourceID Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen der ID Eigenschaft des Datenquellensteuerelements, das das Datenauflistungssteuerelement zum Abrufen der Datenquelle verwenden soll.
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, setPublic Overridable Property DataSourceID As StringEigenschaftswert
Der programmgesteuerte Bezeichner, der dem Datenquellensteuerelement zugewiesen ist.
- Attribute
Ausnahmen
Die Datenquelle kann nicht aufgelöst werden, da ein Wert sowohl für die DataSource Eigenschaft als auch für die DataSourceID Eigenschaft angegeben wird.
Hinweise
Verwenden Sie die DataSourceID Eigenschaft, um auf die ID Eigenschaft des Datenquellensteuerelements zuzugreifen, mit dem das Datenauflistungssteuerelement seine Datenquelle abrufen soll. Das datenquellenbasierte Steuerelement, auf das von der DataSourceID Eigenschaft verwiesen wird, kann ein beliebiges Steuerelement sein, das die IDataSource Schnittstelle implementiert. Das Datenquellensteuerelement muss entweder im gleichen Benennungscontainer wie das Datenauflistungssteuerelement vorhanden sein, das darauf verweist, oder in einem übergeordneten Steuerelement des Datenauflistungssteuerelements. 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 von Werten 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 ) oder System.Collections.Generic.List<T>die IListSource Schnittstelle implementiert, die 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 eine System.Web.HttpException Ausnahme ausgelöst wird.
Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und ASP.NET Designs und Skins.
