System.Web 2.0.0.0 System.Object

ASP.NET supports a data-binding architecture that enables Web server controls to bind to data in a consistent fashion. Web server controls that bind to data are referred to as data-bound controls, and the classes that facilitate that binding are called data source controls. Data source controls can represent any data source: a relational database, a file, a stream, a business object, and so on. Data source controls present data in a consistent way to data-bound controls, regardless of the source or format of the underlying data.

You use the data source controls that are provided with ASP.NET, including , , and , to perform most Web development tasks. You use the base and classes when you want to implement your own custom data source control.

You can think of a data source control as the combination of the object and its associated lists of data, called data source views. Each list of data is represented by a object. The class is the base class for all data source views, or lists of data, associated with data source controls. Data source views define the capabilities of a data source control. Because the underlying data storage contains one or more lists of data, a data source control is always associated with one or more named data source views. The data source control uses the method to enumerate the data source views currently associated with the data source control and the method to retrieve a specific data source view instance by name.

All objects support data retrieval from the underlying data source using the method. All views optionally support a basic set of operations, including operations such as , , and . A data-bound control can discover the capabilities of a data source control by retrieving an associated data source view using the and methods, and by querying the view at design time or run time.

Serves as the base class for all data source view classes, which define the capabilities of data source controls.

- Constructor
  To be added.

  Initializes a new instance of the class.

  The data source control that the is associated with.
  The name of the object.
  2.0.0.0
- Property
  System.Boolean To be added.

  The property reflects not only a capability of the data source control, but also whether it is currently appropriate to perform an operation. For example, even though a data source view supports the operation in general, if a required property or some other data is not set, the property returns false, as a delete operation would fail.

  Gets a value indicating whether the object associated with the current object supports the operation.

  2.0.0.0
- Property
  System.Boolean To be added.

  The property reflects not only a capability of the data source control, but also whether it is currently appropriate to perform an operation. For example, even though a data source control supports the operation, if a required insert command or some other data is not set, the property returns false, as an insert operation would fail.

  Gets a value indicating whether the object associated with the current object supports the operation.

  2.0.0.0
- Property
  System.Boolean To be added.

  A data-bound control can request paging by adding the field to the object passed to the method. If a data-bound control requests paging, but the property returns false, the data source view throws an exception.

  Gets a value indicating whether the object associated with the current object supports paging through the data retrieved by the method.

  2.0.0.0
- Property
  System.Boolean To be added.

  A data-bound control can request a total row count by adding the field to the object passed to the method. If a data-bound control requests a total row count, but the property returns false, the data source view throws an exception.

  Gets a value indicating whether the object associated with the current object supports retrieving the total number of data rows, instead of the data.

  2.0.0.0
- Property
  System.Boolean To be added.

  A data-bound control can request sorting by adding the field to the object passed to the method. If a data-bound control requests sorting, but the property returns false, the data source view throws an exception.

  Gets a value indicating whether the object associated with the current object supports a sorted view on the underlying data source.

  2.0.0.0
- Property
  System.Boolean To be added.

  The property reflects not only a capability of the data source control, but also whether it is currently appropriate to perform an operation. For example, even though a data-bound control supports the operation, if a required update command or some other data is not set, the property returns false, as an update operation would fail.

  Gets a value indicating whether the object associated with the current object supports the operation.

  2.0.0.0
- Event
  System.EventHandler

  The change to the data source view could be due to a change in the values of its properties, or to a change in the data due to a data operation performed by the data source view.

  For more information about handling events, see Consuming Events.

  Occurs when the data source view has changed.

  2.0.0.0
- Method
  System.Void `` `` `` To be added. To be added.

  The method is the asynchronous data deletion interface for all data source view objects. The method calls the method using any and parameter values supplied. The parameter is a delegate that a data-bound control passes to the data source view, which is used to notify the data-bound control when the operation has completed. The method uses the parameters of the delegate to return the number of affected records and any exception that is thrown by the method.

  Performs an asynchronous delete operation on the list of data that the object represents.

  An of object or row keys to be deleted by the operation. 2.0.0.0
- Property
  System.ComponentModel.EventHandlerList To be added.

  This property is of type , which uses a linear search algorithm to find entries in the list of delegates. A linear search algorithm is inefficient when working with a large number of entries. Therefore, when you have a large list, finding entries with this property will be slow.

  Gets a list of event-handler delegates for the data source view.

  2.0.0.0
- Method
  System.Int32 `` `` To be added.

  Data-bound controls can determine whether the operation is supported by a data source control by retrieving the object using the method, and checking the property.

  The parameter represents the object or row keys of the data to delete. For data sources that represent relational data, such as the control, the parameter is a collection of database primary keys. In other scenarios, the parameter is a collection of name/value pairs and is used to filter a list of data. Any data matching a name/value pair is deleted.

  The class's default implementation is to throw a exception. If you extend the class, override the method if your class supports deletion from the underlying data storage.

  Performs a delete operation on the list of data that the object represents.

  The number of items that were deleted from the underlying data storage.

  An of object or row keys to be deleted by the operation. 2.0.0.0
- Method
  System.Int32 `` To be added.

  Data-bound controls can determine whether the operation is supported by a data source control by retrieving the object using the method, and checking the property.

  The parameter is a set of name/value pairs that represents data columns or fields and corresponding values to insert.

  The class's default implementation is to throw a exception. If you extend the class, override the method if your class supports insertion into the underlying data storage.

  Performs an insert operation on the list of data that the object represents.

  The number of items that were inserted into the underlying data storage.

  2.0.0.0
- Method
  2.0.0.0
  System.Collections.IEnumerable ``

  The method is called to retrieve data from the underlying data store and return it as an object. All data source controls support data retrieval from their underlying data storage, even if other operations such as insertion and sorting are not supported. Because a data-bound control can request a list of data at any time as a result of a event or a method call, the data retrieval must be performed on demand.

  Gets a list of data from the underlying data storage.

  An list of data from the underlying data storage.

  A that is used to request operations on the data beyond basic data retrieval.
- Method
  System.Int32 `` `` ``

  Data-bound controls can determine whether the operation is supported by a data source control by using the method to retrieve the object and checking the value of the property.

  The parameter represents the object or row keys of the data to update. For data sources that represent relational data, such as the control, the parameter is a collection of database primary keys. In other scenarios, the parameter is a collection of name/value pairs and is used to filter a list of data. Any data matching a name/value pair is updated with the values found in the parameter, which is a set of name/value pairs that represents new values for existing fields or columns.

  The class's default implementation is to throw a exception. If you extend the class, override the method if your class supports updating data in the underlying data storage.

  Performs an update operation on the list of data that the object represents.

  The number of items that were updated in the underlying data storage.

  An of object or row keys to be updated by the update operation. An of name/value pairs that represent data elements and their new values. An of name/value pairs that represent data elements and their original values. 2.0.0.0
- Method
  System.Void `` `` To be added.

  The method is the asynchronous data insertion interface for all data source view objects. The method calls the method using any supplied. The parameter is a delegate that a data-bound control passes to the data source view, which is used to notify the data-bound control when the operation has completed. The method uses the parameters of the delegate to return the number of affected records and any exception that is thrown by the method call.

  Performs an asynchronous insert operation on the list of data that the object represents.

  An of name/value pairs used during an insert operation. 2.0.0.0
- Property
  System.String To be added. To be added.

  Gets the name of the data source view.

  2.0.0.0
- Method
  System.Void `` To be added.

  The method notifies a data-bound control that the underlying data source has changed and that the control should rebind and perform any necessary work. Typically, the method is called when a property of the data source view has changed.

  Raising an event invokes the event handler through a delegate. For more information, see Raising an Event.

  The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

  Raises the event.

  2.0.0.0
- Method
  2.0.0.0
  System.Void ``

  The method is used by the data source view to examine each of the capabilities requested by a data-bound control, represented by the object passed to the method, and compare it to the capabilities supported by the data source view.

  Called by the method to compare the capabilities requested for an operation against those that the view supports.

  One of the values that is compared against the capabilities that the view supports.
- Method
  System.Void `` `` To be added. To be added.

  The method is the asynchronous data retrieval interface for all data source view objects. The method calls the method, passing any supplied. The parameter is a delegate that a data-bound control passes to the data source view, which is used to notify the data-bound control when the operation has completed. The data returned by the call is returned in the parameter of the delegate.

  Gets a list of data asynchronously from the underlying data storage.

  2.0.0.0
- Method
  System.Void `` `` `` `` To be added.

  The method is the asynchronous data modification interface for all data source view objects. The method calls the method using any , , and parameter values supplied. The parameter is a delegate that a data-bound control passes to the data source view, which is used to notify the data-bound control when the operation has completed. The method uses the parameters of the delegate to return the number of affected records and any exception that is thrown by the call.

  Performs an asynchronous update operation on the list of data that the object represents.

  An of object or row keys to be updated by the update operation. An of name/value pairs that represent data elements and their new values. An of name/value pairs that represent data elements and their original values. 2.0.0.0