BaseDataList.DataSourceID Proprietà

Definizione

Spazio dei nomi:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Ottiene o imposta la ID proprietà del controllo origine dati che il controllo elenco dati deve utilizzare per recuperare l'origine dati.

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

Valore della proprietà

String

Identificatore programmatico assegnato al controllo origine dati.

Attributi

ThemeableAttribute

Eccezioni

HttpException

Impossibile risolvere l'origine dati perché viene specificato un valore sia per la DataSource proprietà che per la DataSourceID proprietà .

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. Il controllo origine dati a cui fa riferimento la DataSourceID proprietà può essere qualsiasi controllo che implementa l'interfaccia IDataSource . Il controllo origine dati deve esistere nello stesso contenitore di denominazione del controllo elenco dati che vi fa riferimento o in un controllo padre del controllo elenco dati. Quando si specifica un valore per questa proprietà, il controllo elenco dati viene associato automaticamente al controllo origine dati specificato. Non è necessario scrivere codice che chiama in modo esplicito il DataBind metodo .

In alternativa, è possibile utilizzare la DataSource proprietà per specificare l'origine dei valori da associare a un controllo elenco dati. L'origine dati deve essere una raccolta che implementa l'interfaccia System.Collections.IEnumerable ( ad System.Data.DataViewesempio , System.Collections.ArrayListo System.Collections.Generic.List<T>) o l'interfaccia IListSource da associare a un controllo derivato dalla BaseDataList classe . Quando si imposta la DataSource proprietà , è necessario scrivere manualmente il codice per eseguire il data binding.

Se vengono specificati valori sia per la DataSource proprietà che per la DataSourceID proprietà , ASP.NET non è in grado di risolvere l'origine dati e viene generata un'eccezione System.Web.HttpException .

Questa proprietà non può essere impostata in base a temi o temi del foglio di stile. Per altre informazioni, vedere ThemeableAttribute e ASP.NET Temi e interfacce.

Vedi anche

• DataSource