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 usare 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 lo fa riferimento o in un controllo padre del controllo elenco dati. Quando si specifica un valore per questa proprietà, il controllo elenco dati associa automaticamente al controllo origine dati specificato. Non è necessario scrivere codice che chiama in modo esplicito il DataBind metodo.

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

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

Vedi anche

• DataSource