Export (0) Print
Expand All

BaseDataList.DataSourceID Property

Gets or sets the ID property of the data source control that the data listing control should use to retrieve its data source.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

[<ThemeableAttribute(false)>]
abstract DataSourceID : string with get, set
[<ThemeableAttribute(false)>]
override DataSourceID : string with get, set
<asp:BaseDataList DataSourceID="String" />

Property Value

Type: System.String
The programmatic identifier assigned to the data source control.

ExceptionCondition
HttpException

The data source cannot be resolved because a value is specified for both the DataSource property and the DataSourceID property.

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. The data source control referenced by the DataSourceID property can be any control that implements the IDataSource interface. 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. When you specify a value for this property, the data listing control automatically binds to the specified data source control. You do not need to write code that explicitly calls the DataBind method.

Alternately, you can use the DataSource property to specify the source of values to bind to a data listing control. 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. When you set the DataSource property, you must manually write the code to perform data binding.

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.

This property cannot be set by themes or style sheet themes. For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft