BaseDataList.DataSourceID Egenskap

Definition

Hämtar eller anger egenskapen för ID den datakällakontroll som datalistningskontrollen ska använda för att hämta datakällan.

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

Egenskapsvärde

Den programmatiska identifierare som tilldelats till datakällans kontroll.

Attribut

Undantag

Det går inte att matcha datakällan eftersom ett värde har angetts för både DataSource egenskapen och DataSourceID egenskapen.

Kommentarer

DataSourceID Använd egenskapen för att komma åt ID egenskapen för den datakällakontroll som datalistningskontrollen ska använda för att hämta datakällan. Datakällans kontroll som refereras av DataSourceID egenskapen kan vara vilken kontroll som helst som implementerar IDataSource gränssnittet. Datakällans kontroll måste finnas antingen i samma namngivningscontainer som datalistningskontrollen som refererar till den, eller i en överordnad kontroll av datalistningskontrollen. När du anger ett värde för den här egenskapen binder datalistningskontrollen automatiskt till den angivna datakällans kontroll. Du behöver inte skriva kod som uttryckligen anropar DataBind metoden.

Alternativt kan du använda DataSource egenskapen för att ange källan för värden som ska bindas till en datalistekontroll. Datakällan måste vara en samling som implementerar gränssnittet (till exempel , eller ) eller System.Collections.IEnumerable gränssnittet för att binda till en kontroll som härletts System.Data.DataView från System.Collections.ArrayList klassen.System.Collections.Generic.List<T>IListSourceBaseDataList När du anger egenskapen DataSource måste du skriva koden manuellt för att utföra databindningen.

Om värden anges för både egenskapen DataSource och egenskapen DataSourceID kan ASP.NET inte matcha datakällan och ett System.Web.HttpException-undantag genereras.

Den här egenskapen kan inte anges med teman eller formatmallsteman. Mer information finns i ThemeableAttribute and ASP.NET Themes and Skins.

Gäller för

Se även