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.
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
Der programmgesteuerte Bezeichner, der dem Datenquellen-Steuerelement zugewiesen ist.
- 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.
Hinweise
Verwenden Sie die DataSourceID Eigenschaft, um auf die ID Eigenschaft des Datenquellensteuerelements zuzugreifen, das das Datenauflistungssteuerelement zum Abrufen der Datenquelle verwenden soll. Das von der DataSourceID Eigenschaft referenzierte Datenquellensteuerelement 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, bindet das Datenauflistungssteuerelement automatisch an das angegebene Datenquellensteuerelement. 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 System.Collections.Generic.List<T>) implementiert oder die IListSource Schnittstelle zum Binden an ein Steuerelement implementiert, das von der BaseDataList Klasse abgeleitet ist. 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.