BaseDataList.DataSourceID Proprietà

Definizione

Spazio dei nomi:

System.Web.UI.WebControls

Assembly:

System.Web.dll

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

Attributi

ThemeableAttribute

Eccezioni

HttpException

L'origine dati non può essere risolta perché è stato specificato un valore sia per la proprietà DataSource che per la proprietà DataSourceID.

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 di dati che vi fa riferimento o in un controllo padre del controllo elenco di 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 di dati. L'origine dati deve essere una raccolta che implementa l'interfaccia System.Collections.IEnumerable (ad esempio System.Data.DataView, 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 proprietà che per la DataSourceDataSourceID 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 da temi oppure temi di fogli di stile. Per altre informazioni, vedere ThemeableAttribute e ASP.NET Temi e interfacce.

Vedi anche

• DataSource