BaseDataList.DataSourceID Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de ID eigenschap op van het besturingselement voor de gegevensbron die door het besturingselement voor het weergeven van gegevens moet worden gebruikt om de gegevensbron op te halen.
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 StringWaarde van eigenschap
De programmatische id die is toegewezen aan het besturingselement voor gegevensbronnen.
- Kenmerken
Uitzonderingen
De gegevensbron kan niet worden omgezet omdat er een waarde is opgegeven voor zowel de DataSource eigenschap als de DataSourceID eigenschap.
Opmerkingen
Gebruik de DataSourceID eigenschap om toegang te krijgen tot de ID eigenschap van het gegevensbronbesturingselement dat door het besturingselement voor gegevensvermeldingen moet worden gebruikt om de gegevensbron op te halen. Het besturingselement voor de gegevensbron waarnaar wordt verwezen door de DataSourceID eigenschap kan elk besturingselement zijn waarmee de IDataSource interface wordt geïmplementeerd. Het besturingselement voor gegevensbronnen moet bestaan in dezelfde naamgevingscontainer als het besturingselement voor gegevensvermelding waarnaar wordt verwezen, of in een bovenliggend besturingselement van het besturingselement voor gegevensvermeldingen. Wanneer u een waarde voor deze eigenschap opgeeft, wordt het besturingselement voor het weergeven van gegevens automatisch gekoppeld aan het opgegeven besturingselement voor gegevensbronnen. U hoeft geen code te schrijven waarmee de DataBind methode expliciet wordt aangeroepen.
U kunt de DataSource eigenschap ook gebruiken om de bron van waarden op te geven die moeten worden gekoppeld aan een besturingselement voor gegevensvermeldingen. De gegevensbron moet een verzameling zijn waarmee de System.Collections.IEnumerable interface (zoals System.Data.DataView, System.Collections.ArrayListof System.Collections.Generic.List<T>) of de IListSource interface wordt geïmplementeerd om verbinding te maken met een besturingselement dat is afgeleid van de BaseDataList klasse. Wanneer u de DataSource eigenschap instelt, moet u de code handmatig schrijven om gegevensbinding uit te voeren.
Als waarden zijn opgegeven voor zowel de eigenschap DataSource als de eigenschap DataSourceID, kan ASP.NET de gegevensbron niet oplossen en wordt er een System.Web.HttpException-uitzondering gegenereerd.
Deze eigenschap kan niet worden ingesteld op thema's of opmaakmodellen. Zie ThemeableAttribute en ASP.NET Thema's en skins voor meer informatie.
