System.Web 2.0.0.0 System.Object

Data-bound controls use the class to request that a data source control performs additional data-related operations on a result set, such as sorting the data or returning a specific subset of data. These data-related operations are enumerated by the enumeration. The following table indicates how the class supports these data-related operations.

Capability

Related DataSourceSelectArguments properties

,

,

Data-bound controls explicitly call the method to bind data, which calls the method of the data source control they are associated with. In this way, the data-bound control retrieves data from the data source control on demand. Because the method accepts a parameter, the data-bound control is responsible for creating and managing a object and passing it to the method when it retrieves data from the data source control.

In some cases, data-bound controls might not need any additional data-related capabilities. In this case, data-bound controls pass an arguments object to the method.

For sorted result sets, data-bound controls check a data source view's property at run time, and add a capability using the method. As a separate operation, the data-bound control can request a sorted result set from a data source control by setting the property on the object passed to the method.

For paging scenarios, data-bound controls check a data source view's property at run time, and add a capability using the method. As a separate operation, the data-bound control can request a subset of data from a data source control for paging by setting the and properties on the object passed to the method.

To retrieve a total row count for paging scenarios, data-bound controls check a data source view's property at run time, and add a capability using the method. As a separate operation, the data-bound control can request a total row count from a data source control for paging by setting the property on the object passed to the method. When the method returns, the total row count is contained by the property.

If any of the properties are set, but the currently bound data source control does not support the requested capability, an exception is thrown when the method is called.

Provides a mechanism that data-bound controls use to request data-related operations from data source controls when data is retrieved. This class cannot be inherited.

- Constructor

  The default constructor creates an instance of the class with the property initialized to and the and properties initialized to zero.

  Initializes a new default instance of the class.

  2.0.0.0
- Constructor

  The constructor creates an instance of the class with the initialized with the specified expression and the and properties initialized to zero.

  Initializes a new instance of the class with the specified sort expression.

  A sort expression that data source controls use to sort the result of a data retrieval operation before the result is returned to a caller.
  2.0.0.0
- Constructor
  To be added.
  To be added.

  The constructor creates an instance of the class with the initialized to and the and properties initialized to the values provided for the and parameters.

  Initializes a new instance of the class with the specified starting position and number of rows to return for paging scenarios.

  2.0.0.0
- Constructor
  To be added.
  To be added.
  To be added.

  Initializes a new instance of the class with the specified sort expression, starting position, and number of rows to return for paging scenarios.

  A sort expression that data source controls use to sort the result of a data retrieval operation before the result is returned to a caller.
  2.0.0.0
- Method
  System.Void `` To be added.

  Data source controls call the method for each capability the data source supports. After the capabilities are added, any call to the method compares the supported capabilities against the requested capabilities (represented by setting the , , , and properties). For example, if a capability such as is not added but the property is set, the method throws a exception.

  Adds one capability to the instance, which is used to compare supported capabilities and requested capabilities.

  2.0.0.0
- Property
  System.Web.UI.DataSourceSelectArguments To be added.

  The property returns a object created with the default constructor. You can use the property when you want to call the method of a data source view class without any additional arguments.

  Gets a object with the sort expression set to .

  2.0.0.0
- Method
  System.Boolean ``

  The class overrides the method to test equality using the various properties of the objects. If the , , , , and properties are all equal in value, the method returns true.

  Determines whether the specified instance is equal to the current instance.

  true if the specified is equal to the current instance; otherwise, false.

  The to compare with the current one. 2.0.0.0
- Method
  System.Int32 To be added.

  Returns the hash code for the type.

  The hash code for the type.

  2.0.0.0
- Property
  System.Int32 To be added.

  The property supports paging scenarios. Data-bound controls check a data source view's property at run time, and add a capability using the method if the view supports paging. If the data-bound control fails to add the capability, and the paging properties are set on a object passed to the data source view during a data retrieval operation, an exception might be thrown.

  The data-bound control can request a subset of data from a data source control for paging by setting the and properties on the object passed to the method.

  If any of the properties are set, but the currently bound data source control does not support the requested capability, an exception is thrown when the method is called.

  Gets or sets a value that represents the maximum number of data rows that a data source control returns for a data retrieval operation.

  2.0.0.0
- Method
  System.Void ``

  The method is used by data-bound controls to compare additional requested capabilities represented by the properties of the class, such as the ability to sort or page through a result set, with the capabilities supported by the data source view. The view calls its own method for each possible capability defined in the enumeration.

  If any of the properties are set, but the currently bound data source control does not support the requested capability, an exception is thrown when the method is called.

  Compares the capabilities requested for an operation against those that the specified data source view supports.

  The data source view that performs the data retrieval operation. 2.0.0.0
- Property
  System.Boolean To be added.

  The property supports paging scenarios. Set this property to true to request a total row count from the data source control during the data-retrieval operation. Check the property to determine whether a data source view supports retrieving a total row count. If the data source supports it, the property is set by the data source control during the course of a data retrieval operation and the total data row count is returned in the property, much as a value is returned in an output parameter of a method.

  If any of the properties are set, but the currently bound data source control does not support the requested capability, an exception is thrown when the method is called.

  Gets or sets a value indicating whether a data source control should retrieve a count of all the data rows during a data retrieval operation.

  2.0.0.0
- Property
  System.String To be added.

  The property supports sorting scenarios.

  Gets or sets an expression that the data source view uses to sort the data retrieved by the method.

  2.0.0.0
- Property
  System.Int32 To be added.

  The property supports paging scenarios. Data-bound controls check a data source view's property at run time, and add a capability using the method if the view supports paging. If the data-bound control fails to add the capability, and the paging properties are set on a object passed to the data source view during a data retrieval operation, an exception might be thrown.

  As a separate operation, the data-bound control can request a subset of data from a data source control by setting the and properties on the object passed to the method.

  Gets or sets a value that represents the starting position the data source control should use when retrieving data rows during a data retrieval operation.

  2.0.0.0
- Property
  System.Int32 To be added.

  The property supports paging scenarios. Data source and data source view controls differ in their internal implementation for how to retrieve total row counts. Check the property to determine whether a data source view supports retrieving a total row count during a data-retrieval operation. If the data source supports it, the property is set by the data source control during the course of a data-retrieval operation, and the total data row count is returned in the property, much as a value is returned in an output parameter of a method.

  Gets or sets the number of rows retrieved during a data retrieval operation.

  2.0.0.0