BaseDataList.DataSourceID Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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, setPublic Overridable Property DataSourceID As StringValor da propriedade
O identificador programático atribuído ao controle da fonte de dados.
- Atributos
Exceções
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 de 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 é associado automaticamente 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 origem dos 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 a ser associada 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 para 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.
