BaseDataList.DataSourceID Propriedade

Definição

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Obtém ou define a propriedade ID do controle de fonte de dados que o controle de listagem de dados deve usar para recuperar sua fonte de dados.

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

Valor da propriedade

String

O identificador programático atribuído ao controle da fonte de dados.

Atributos

ThemeableAttribute

Exceções

HttpException

A fonte de dados não pode ser resolvida porque foi especificado um valor para as propriedades DataSource e DataSourceID.

Comentários

Use a DataSourceID propriedade para acessar a ID propriedade do controle da fonte de dados que o controle de listagem de dados deve usar para recuperar sua fonte de dados. O controle da fonte de dados referenciado pela DataSourceID propriedade pode ser qualquer controle que implemente a IDataSource interface. O controle da fonte de dados deve existir no mesmo contêiner de nomenclatura que o controle de listagem de dados que faz referência a ele ou em um controle pai do controle de listagem de dados. Quando você especifica um valor para essa propriedade, o controle de listagem de dados é automaticamente associado ao controle de fonte de dados especificado. Você não precisa escrever um código que chame explicitamente o DataBind método.

Como alternativa, você pode usar a DataSource propriedade para especificar a fonte de valores a serem associados a um controle de listagem de dados. A fonte de dados deve ser uma coleção que implemente a System.Collections.IEnumerable interface (como System.Data.DataView, System.Collections.ArrayListou System.Collections.Generic.List<T>) ou a IListSource interface para associar a um controle derivado da BaseDataList classe. Ao definir a DataSource propriedade, você deve escrever manualmente o código para executar a associação de dados.

Se os valores forem especificados para a DataSource propriedade e a DataSourceID propriedade, ASP.NET não poderá resolver a fonte de dados e uma exceção System.Web.HttpException será gerada.

Essa propriedade não pode ser definida por temas ou temas de folha de estilos. Para obter mais informações, consulte ThemeableAttribute e ASP.NET Temas e Peles.

Confira também

• DataSource