BaseDataList.DataSourceID Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define a ID propriedade do controlo de fonte de dados que o controlo de listagem de dados deve usar para recuperar a 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 de Propriedade
O identificador programático atribuído ao controlo de fonte dos dados.
- Atributos
Exceções
A fonte de dados não pode ser resolvida porque um valor é especificado tanto para a DataSource propriedade como para a propriedade DataSourceID .
Observações
Use a DataSourceID propriedade para aceder à ID propriedade do controlo de fonte de dados que o controlo de listagem de dados deve usar para recuperar a sua fonte de dados. O controlo de fonte de dados referenciado pela DataSourceID propriedade pode ser qualquer controlo que implemente a IDataSource interface. O controlo de fonte de dados deve existir ou no mesmo contentor de nomenclatura do controlo de listagem de dados que o referencia, ou num controlo pai do controlo de listagem de dados. Quando especifica um valor para esta propriedade, o controlo de listagem de dados liga-se automaticamente ao controlo de fonte de dados especificado. Não precisas de escrever código que chame explicitamente o DataBind método.
Alternativamente, pode usar a DataSource propriedade para especificar a fonte dos valores a atribuir a um controlo 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.ArrayList, ou System.Collections.Generic.List<T>) ou a IListSource interface para se ligar a um controlo derivado da BaseDataList classe. Quando defines a DataSource propriedade, tens de escrever manualmente o código para realizar a ligação de dados.
Se forem especificados valores tanto para a propriedade DataSource como para a propriedade DataSourceID, ASP.NET não conseguir resolver a fonte de dados e é lançada uma exceção System.Web.HttpException.
Esta propriedade não pode ser definida por temas ou temas de folhas de estilo. Para mais informações, consulte ThemeableAttribute e ASP.NET Temas e Skins.