BaseDataList.DataSourceID BaseDataList.DataSourceID BaseDataList.DataSourceID BaseDataList.DataSourceID Property

Definizione

Ottiene o imposta la proprietà ID del controllo origine dati che il controllo elenco dati deve utilizzare per recuperare la propria origine dati.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

Valore della proprietà

Identificatore a livello di codice assegnato al controllo origine dati.The programmatic identifier assigned to the data source control.

Eccezioni

L'origine dati non può essere risolta perché è stato specificato un valore sia per la proprietà DataSource che per la proprietà DataSourceID.The data source cannot be resolved because a value is specified for both the DataSource property and the DataSourceID property.

Commenti

Utilizzare la DataSourceID proprietà per accedere alla ID proprietà del controllo origine dati che il controllo elenco dati deve utilizzare per recuperare l'origine dati.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. Il controllo origine dati a cui fa riferimento DataSourceID la proprietà può essere qualsiasi controllo che implementa IDataSource l'interfaccia.The data source control referenced by the DataSourceID property can be any control that implements the IDataSource interface. Il controllo origine dati deve essere presente nello stesso contenitore di denominazione del controllo elenco dati che vi fa riferimento o in un controllo padre del controllo elenco dati.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. Quando si specifica un valore per questa proprietà, il controllo elenco dati viene associato automaticamente al controllo origine dati specificato.When you specify a value for this property, the data listing control automatically binds to the specified data source control. Non è necessario scrivere codice che chiama in modo esplicito il DataBind metodo.You do not need to write code that explicitly calls the DataBind method.

In alternativa, è possibile usare la DataSource proprietà per specificare l'origine dei valori da associare a un controllo elenco dati.Alternately, you can use the DataSource property to specify the source of values to bind to a data listing control. L'origine dati deve essere una raccolta che implementa l' System.Collections.IEnumerable interfaccia ( System.Data.DataViewad esempio, System.Collections.ArrayListo System.Collections.Generic.List<T>) BaseDataList o l' IListSource interfaccia da associare a un controllo derivato dalla classe.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. Quando si imposta la DataSource proprietà, è necessario scrivere manualmente il codice per eseguire Data Binding.When you set the DataSource property, you must manually write the code to perform data binding.

Se vengono specificati valori per la DataSource proprietà e la DataSourceID proprietà, ASP.NET non è in grado di risolvere l'origine dati e viene System.Web.HttpException generata un'eccezione.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.

Questa proprietà non può essere impostata da temi oppure temi di fogli di stile.This property cannot be set by themes or style sheet themes. Per ulteriori informazioni, vedere ThemeableAttribute e ASP.NET temi e interfacce.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

Si applica a

Vedi anche