BaseDataList.DataSourceID Propriedade
Definição
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
O identificador programático atribuído ao controle da fonte de dados.The programmatic identifier assigned to the data source control.
- Atributos
Exceções
A fonte de dados não pode ser resolvida porque foi especificado um valor para as propriedades DataSource e DataSourceID.The data source cannot be resolved because a value is specified for both the DataSource property and the DataSourceID property.
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.Use the DataSourceID property to access the ID property of the data source control that the data listing control should use to retrieve its data source. O controle da fonte de dados referenciado pela DataSourceID propriedade pode ser qualquer controle que implemente a IDataSource interface.The data source control referenced by the DataSourceID property can be any control that implements the IDataSource interface. O controle da fonte de dados deve existir no mesmo contêiner de nomeação que o controle de listagem de dados que faz referência a ele ou em um controle pai do controle de listagem de dados.The data source control must exist either in the same naming container as the data listing control that references it, or in a parent control of the data listing control. Quando você especifica um valor para essa propriedade, o controle de listagem de dados é associado automaticamente ao controle de fonte de dados especificado.When you specify a value for this property, the data listing control automatically binds to the specified data source control. Você não precisa escrever código que chame explicitamente o DataBind método.You do not need to write code that explicitly calls the DataBind method.
Como alternativa, você pode usar a DataSource propriedade para especificar a origem dos valores a serem associados a um controle de listagem de dados.Alternately, you can use the DataSource property to specify the source of values to bind to a data listing control. A fonte de dados deve ser uma coleção que implementa a System.Collections.IEnumerable interface (como System.Data.DataView , System.Collections.ArrayList ou System.Collections.Generic.List<T> ) ou a IListSource interface para associar a um controle derivado da BaseDataList classe.The data source must be a collection that implements the System.Collections.IEnumerable interface (such as System.Data.DataView, System.Collections.ArrayList, or System.Collections.Generic.List<T>) or the IListSource interface to bind to a control derived from the BaseDataList class. Ao definir a DataSource propriedade, você deve escrever manualmente o código para executar a vinculação de dados.When you set the DataSource property, you must manually write the code to perform data binding.
Se os valores forem especificados para a DataSource propriedade e a DataSourceID propriedade, ASP.net não será capaz de resolver a fonte de dados e uma System.Web.HttpException exceção será lançada.If values are specified for both the DataSource property and the DataSourceID property, ASP.NET is not able to resolve the data source and an System.Web.HttpException exception is thrown.
Esta propriedade não pode ser definida por temas ou temas de folha de estilo.This property cannot be set by themes or style sheet themes. Para obter mais informações, consulte ThemeableAttribute e temas e capas do ASP.net.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.