System.Web 2.0.0.0 System.Web.UI.DataSourceView System.Web.UI.IStateManager

The class is intended primarily to be used by data-bound controls, and not as a programmable object in page code.

ASP.NET data source controls contain one or more lists of data, represented by data source view objects. The class extends the class, defines the capabilities of the control with which it is associated, and implements the basic data functionality for the data source control. The class implements the data functionality for the control, including the , , , and operations, sorting, filtering, and managing settings that are kept in view state.

Although the object is not directly exposed to page developers by the control, many of its properties are. The most basic operation that a data source view performs is data retrieval from the underlying database using the method, which retrieves an collection of data items. The class implements data retrieval from relational databases using SQL queries. The SQL queries can be parameterized for greater flexibility and security. The following data retrieval methods, properties, and events are implemented by the and exposed directly by its control to page developers and other callers:

The property

The property

The event

The event

The object supports updating data in a relational database using SQL commands. The SQL commands can be parameterized for greater flexibility and security. Data-bound controls, such as the and , can be configured to perform updates automatically using the , while other controls cannot. The following update methods, properties, and events are implemented by the and exposed directly by its control to page developers and other callers:

The property

The property

The event

The event

The supports inserting new rows of data into a relational database. The SQL commands that are specified in the property can be parameterized for greater flexibility and security. Data-bound controls, such as the and , can be configured to perform inserts automatically using the , while other controls cannot. The following insert methods, properties, and events are implemented by the and exposed directly by its control to page developers and other callers:

The property

The property

The event

The event

The object also supports deleting data from a relational database. As with other commands, the SQL commands that are specified in the property can be parameterized for greater flexibility and security. Data-bound controls, such as the and , can be configured to perform deletes automatically using the , while other controls cannot. The following delete methods, properties, and events are implemented by the and exposed directly by its control to page developers and other callers:

The property

The property

The event

The event

Data retrieval is more powerful when the clause that is used to filter the data during data retrieval is dynamic. In other words, an SQL query with a static WHERE clause is not as flexible and powerful as an SQL query where the values in the WHERE clause are bound to values that can change, such as values that are displayed in controls on a Web Forms page. Instead of rebuilding an SQL query and setting the property on every page load, you can use the and properties to apply dynamic filtering to data retrieval. These properties are implemented by the and exposed directly by its control to data-bound controls and other callers.

You can sort the data that you retrieve with the control by adding an ORDER BY clause, which causes the database to perform the ordering for you when you retrieve data or by ordering the data in memory after it is retrieved. You can supply a sorting expression to the by setting the property of the object that is passed to the method. The syntax for the property is the same as the syntax for a property. If you use a stored procedure to retrieve data, you can also use the property to specify a parameter that is used specifically for sorting the results of a stored procedure call.

When more than one user can change the database concurrently, there is the potential for concurrency conflict. The control has controls concurrency through the property. The functionality is implemented in the property.

Like many other Web server controls, the implements the interface and uses view state to track its state across page requests. Implementations of the and property and the , , and methods are provided to enable view state tracking for the control. For more information, see ASP.NET State Management Overview.

Supports the control and provides an interface for data-bound controls to perform SQL data operations against relational databases.

- Constructor

  The constructor is called by the method to return a new instance of a data source view with the specified parameter. The control is associated with only one object at any one time, and always names the view Table, although this naming restriction is imposed by the control, not the . You can override the method to support views with a different naming convention.

  The object that is passed by the parameter is used by the data source view to access parameter objects, such as the and properties.

  Initializes a new instance of the class setting the specified control as the owner of the current view.

  The data source control with which the is associated.
  A unique name for the data source view, within the scope of the data source control that owns it.
  The current .
  2.0.0.0
- Property
  System.Boolean To be added.

  The value of the property is stored in view state.

  Gets or sets a value indicating whether a data retrieval operation is canceled when any parameter that is contained in the collection evaluates to null.

  2.0.0.0
- Property
  System.Boolean To be added.

  The property returns true if the property is set. A delete operation could still fail if all the data properties are not set or are not set correctly.

  Gets a value indicating whether the object that is associated with the current control supports the delete operation.

  2.0.0.0
- Property
  System.Boolean To be added.

  The property returns true if the property is set. An insert operation could still fail if all the data properties are not set or are not set correctly.

  Gets a value indicating whether the object that is associated with the current control supports the insert operation.

  2.0.0.0
- Property
  System.Boolean To be added.

  The object does not support paging.

  Gets a value indicating whether the object that is associated with the current control supports the paging of retrieved data.

  2.0.0.0
- Property
  System.Boolean To be added.

  The object does not support retrieving row counts.

  Gets a value indicating whether the object that is associated with the current control supports retrieving the total number of data rows, in addition to the set of data.

  2.0.0.0
- Property
  System.Boolean To be added.

  The property returns true, if the current property is set to the value and the property is set.

  Gets a value indicating whether the object that is associated with the current control supports a sorted view on the retrieved data.

  2.0.0.0
- Property
  System.Boolean To be added.

  The property returns true if the property is set. A delete operation could still fail if all the data properties are not set or are not set correctly.

  Gets a value indicating whether the object that is associated with the current control supports the update operation.

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

  The property determines whether parameters for old and new values are applied to the Update method. For example, if the command that is specified by the property returns a object with the columns Name and Number, and the property is set to the value, parameters are created for Name and Number for the update operation. If the property is set to the value, parameters are created for Name, Number, original_Name, and original_Number. (The exact name of the parameters for the original values depends on the .) Then, the object determines if the method that is specified in the property has parameters that match.

  Concurrency control is a technique data stores use to control how data is read and changed in the store when multiple clients are accessing and manipulating the same data. For example, one client reads data and presents it to a user, while another client reads the same data, and presents it to a different user. If both users update the data and submit it to the data storage, some unexpected result might occur, because both clients might update different values for the same data. This is considered a conflict. By setting the property to the value, the update operation can then compare the old and new values to the original data source to detect conflicts and handle them as required.

  The value of the property is stored in view state.

  Gets or sets the value indicating how the control performs updates and deletes when data in a row in the underlying database changes during the time of the operation.

  2.0.0.0
- Method
  System.Int32 `` ``

  The method calls the method, passing the and parameters.

  Performs a delete operation using the SQL string, any parameters that are specified in the collection, and the values that are in the specified and collections.

  A value that represents the number of rows deleted from the underlying database.

  An of object or row key values for the operation to delete. An that contains row values that are evaluated only if the property is set to the value. 2.0.0.0
- Property
  System.String To be added.

  Because different database products use different varieties of SQL, the syntax of the SQL string depends on the current ADO.NET provider being used, which is identified by the property.

  If the SQL string is a parameterized query or command, the placeholder of the parameter also depends on the ADO.NET provider being used. For example, if the provider is the , which is the default provider for the class, the placeholder of the parameter is '@parameterName'. However, if the provider is set to the or , the placeholder of the parameter is '?'. For more information on parameterized SQL queries and commands, see Using Parameters with the SqlDataSource Control.

  The can be an SQL string or the name of a stored procedure, if the underlying database supports stored procedures.

  The value of the property is stored in view state.

  Gets or sets the SQL string that the uses to delete data from the underlying database.

  2.0.0.0
- Property
  System.Web.UI.WebControls.SqlDataSourceCommandType To be added.

  The value of the property is stored in view state.

  Gets or sets a value indicating whether the text in the property is a SQL statement or the name of a stored procedure.

  2.0.0.0
- Event
  System.Web.UI.WebControls.SqlDataSourceStatusEventHandler

  Handle the event to examine the values of output parameters after a delete operation has completed. The output parameters are available from the object that is associated with the event.

  For more information about handling events, see Consuming Events.

  Occurs when a delete operation has completed.

  2.0.0.0
- Property
  System.ComponentModel.Editor("System.Web.UI.Design.WebControls.ParameterCollectionEditor, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.Drawing.Design.UITypeEditor, System.Drawing, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")
  System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)
  System.ComponentModel.DefaultValue(null)
  System.Web.UI.WebControls.ParameterCollection To be added.

  If the property contains a parameterized SQL query, the collection contains any objects that correspond to the parameter placeholders in the SQL string.

  Parameter names might be affected by the property; specifically, if the name identifies a primary key, such as a key that is specified using the DataKeyNames property of a data-bound control, or in delete and update scenarios in which the property is set to the value and a set of is passed to the corresponding data method. In this case, the format string is applied to each parameter name in the collection.

  Depending on the ADO.NET provider, the order of the parameters in the collection might be important. The and providers associate the parameters in the collection according to the order that the parameters appear in the parameterized SQL query. The provider, which is the default ADO.NET provider for the control, associates the parameters in the collection by matching the name of the parameter with the placeholder in the SQL query. For more information on parameterized SQL queries and commands, see Using Parameters with the SqlDataSource Control.

  Gets the parameters collection containing the parameters that are used by the property.

  2.0.0.0
- Event
  System.Web.UI.WebControls.SqlDataSourceCommandEventHandler

  Handle the event to perform additional initialization operations that are specific to your application, to validate the values of parameters, or to change the parameter values before the control performs the delete operation.

  The connection to the underlying data source is not yet open when the event handler delegate is called. Therefore, you cannot cancel the operation directly by calling the method on the object that is exposed by the object. You can, however, cancel the operation by setting the property of the to true.

  For more information about handling events, see Consuming Events.

  Occurs before a delete operation.

  2.0.0.0
- Method
  System.Int32 `` ``

  The class implements the inherited method to delete data from a database. Page developers and data-bound control authors do not call the method directly; instead, use the publicly exposed method.

  The values that are contained in the collection are evaluated and merged with any values that are contained by the collection. If the property is set to the value, the values that are contained in the collection are formatted with the property and are also merged.

  Before the delete operation is performed, the method is called to raise the event. You can handle this event to examine the values of the parameters and to perform any preprocessing before a delete.

  To perform a delete operation, the object builds a object using the text and any associated properties, and then executes the object against the underlying database. After the delete operation completes, the method is called to raise the event. You can handle this event to examine any return values and error codes and to perform any post-processing.

  Performs a delete operation using the SQL string, any parameters that are specified in the collection, and the values that are in the specified and collections.

  A value that represents the number of rows deleted from the underlying database.

  An of object or row key values for the operation to delete. An that contains row values that are evaluated only if the property is set to the value. 2.0.0.0
- Method
  System.Int32 ``

  The class implements the inherited method to insert data into a database. Page developers and data-bound control authors do not call the method directly; instead, use the publicly exposed method.

  Before the insert operation is performed, the method is called to raise the event. You can handle this event to examine the values of the parameters and to perform any preprocessing before an insert.

  To perform an insert operation, the object builds a object using the text and any associated properties, and then executes the object against the underlying database. After the insert completes, the method is called to raise the event. You can handle this event to examine any return values and error codes and to perform any post-processing.

  Performs an insert operation using the SQL string, any parameters that are specified in the collection, and the values that are in the specified collection.

  A value that represents the number of rows inserted into the underlying database.

  An of values used with the property to perform the insert database operation. If there are no parameters associated with the query or if the property is not a parameterized SQL query, pass null. 2.0.0.0
- Method
  2.0.0.0
  System.Collections.IEnumerable ``

  The class implements the inherited method to retrieve data from a database. Page developers and data-bound control authors do not call the method directly; instead, use the publicly exposed method.

  Before the data retrieval is performed, the method is called to raise the event. You can handle this event to examine the values of the parameters and to perform any preprocessing before data is retrieved.

  To perform the operation, the object builds a object using the text and any associated , and executes it against the underlying database. After the operation completes, the method is called to raise the event. You can handle this event to examine any return values, error codes, and perform any post-processing.

  The method returns a object if the is set to , or a object if the is set to . Close the object when you have finished reading the data.

  If the is set to and caching is enabled, the retrieves data from and saves data to the cache during the data operation. The cache is created, discarded, or refreshed based on the caching behavior specified by the combination of the and properties.

  When you are using client impersonation under Windows authentication, the data is cached when the first user accesses the data. If another user requests the same data, the data is retrieved from the cache. The data is not retrieved by making another call to the database to verify the user's access to the data. If you expect multiple users to access the data, and you want each retrieval to the data to be verified by the database's security configurations, do not use caching.

  If the is set to and a has been specified, it is evaluated along with any supplied and the resulting filter is applied to the list of data during the data retrieval operation.

  Retrieves data from the underlying database using the SQL string and any parameters that are in the collection.

  An list of data rows.

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

  The class implements the inherited method to update data in a database. Page developers and data-bound control authors do not call the method directly; instead, use the publicly exposed method.

  The values contained in the and collections are evaluated and merged with any values contained by the collection. If the property is set to , the values contained in the collection are formatted with the and also merged.

  Before the update operation is performed, the method is called to raise the event. You can handle this event to examine the values of the parameters and perform any preprocessing before an update.

  To perform the operation, the builds a object using the text and any associated properties, and then executes the object against the underlying database. After the operation completes, the method is called to raise the event. You can handle this event to examine any return values and error codes and to perform any post-processing.

  Performs an update operation using the SQL string, any parameters that are in the collection, and the values that are in the specified , , and collections.

  A value that represents the number of rows updated in the underlying database.

  An of primary keys to use with the property to perform the update database operation. If there are no keys associated with the query or if the property is not a parameterized SQL query, pass null. An of values to use with the property to perform the update database operation. If there are no parameters associated with the query or if the is not a parameterized SQL query, pass null. An that represents the original values in the database. If there are no parameters associated with the query or if the property is not a parameterized SQL query, pass null. 2.0.0.0
- Property
  System.String To be added.

  The syntax that is used for the property is a format string–style syntax. You can include parameters in the property. If the type of the parameter is string or character, enclose the parameter in single quotation marks. Quotation marks are not required, if the parameter is a numeric type.

  The collection contains the parameters that are evaluated for the placeholders that are found in the property.

  The control supports filtering data only when in DataSet mode.

  The value of the property is stored in view state.

  You should validate any filter parameter value that you receive from the client. The runtime simply substitutes the parameter value into the filter expression and applies it to the object that is returned by the method. If you are using the property as a security measure to limit the number of items that are returned, you must validate the parameter values before the filtering occurs.

  Gets or sets a filtering expression that is applied when the method is called.

  2.0.0.0
- Event
  System.Web.UI.WebControls.SqlDataSourceFilteringEventHandler

  Handle the event to perform validation operations on filter parameter values before the object performs a filter operation. You can cancel the method by setting the property of the object to true. The event is raised only if the property is set.

  You should validate any filter parameter value that you receive from the client. The runtime simply substitutes the parameter value into the filter expression and applies it to the object that is returned by the method. If you are using the property as a security measure to limit the number of items that are returned, you must validate the parameter values before the filtering occurs.

  For more information about handling events, see Consuming Events.

  Occurs before a filter operation.

  2.0.0.0
- Property
  System.ComponentModel.DefaultValue(null)
  System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)
  System.ComponentModel.Editor("System.Web.UI.Design.WebControls.ParameterCollectionEditor, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.Drawing.Design.UITypeEditor, System.Drawing, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")
  System.Web.UI.WebControls.ParameterCollection To be added.

  The parameters in the collection are associated with any parameters that are specified in the property. The parameter placeholders that are specified in the are evaluated by order and matched to parameter objects in the collection when the method is called.

  You should validate any filter parameter value that you receive from the client. The runtime simply substitutes the parameter value into the filter expression and applies it to the object that is returned by the method. If you are using the property as a security measure to limit the number of items that are returned, you must validate the parameter values before the filtering occurs.

  Gets a collection of parameters that are associated with any parameter placeholders in the string.

  2.0.0.0
- Method
  System.Int32 ``

  The method calls the method, passing the parameter.

  Performs an insert operation using the SQL string, any parameters that are specified in the collection, and the values that are in the specified collection.

  A value that represents the number of rows inserted into the underlying database.

  An of parameters for the property to use to perform the insert database operation. If there are no parameters associated with the query or if the is not a parameterized SQL query, pass null. 2.0.0.0
- Property
  System.String To be added.

  Because different database products use different varieties of SQL, the syntax of the SQL string depends on the current ADO.NET provider being used, which is identified by the property. If the SQL string is a parameterized query or command, the placeholder of the parameter also depends on the ADO.NET provider being used. For example, if the provider is the , which is the default provider for the class, the placeholder of the parameter is '@parameterName'. However, if the provider is set to the or , the placeholder of the parameter is '?'. For more information on parameterized SQL queries and commands, see Using Parameters with the SqlDataSource Control.

  The property can be an SQL string or the name of a stored procedure, if the data source supports stored procedures.

  The value of the property is stored in view state.

  Gets or sets the SQL string that the object uses to insert data into the underlying database.

  2.0.0.0
- Property
  System.Web.UI.WebControls.SqlDataSourceCommandType To be added.

  The value of the property is stored in view state.

  Gets or sets a value indicating whether the text in the property is a SQL statement or the name of a stored procedure.

  2.0.0.0
- Event
  System.Web.UI.WebControls.SqlDataSourceStatusEventHandler

  Handle the event to examine the values of output parameters after an insert operation has completed. The output parameters are available from the object that is associated with the event.

  For more information about handling events, see Consuming Events.

  Occurs when an insert operation has completed.

  2.0.0.0
- Event
  System.Web.UI.WebControls.SqlDataSourceCommandEventHandler

  Handle the event to perform additional initialization operations that are specific to your application, to validate the values of parameters, or to change the parameter values before the control performs the insert operation.

  The connection to the underlying data source is not yet open when the event handler delegate is called. Therefore, you cannot cancel the database operation directly by calling the method on the object that is exposed by the object. You can, however, cancel the database operation by setting the property of the to true.

  For more information about handling events, see Consuming Events.

  Occurs before an insert operation.

  2.0.0.0
- Property
  System.ComponentModel.DefaultValue(null)
  System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)
  System.ComponentModel.Editor("System.Web.UI.Design.WebControls.ParameterCollectionEditor, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.Drawing.Design.UITypeEditor, System.Drawing, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")
  System.Web.UI.WebControls.ParameterCollection To be added.

  If the property contains a parameterized SQL query, the collection contains any objects that correspond to the parameter placeholders in the SQL string.

  Depending on the ADO.NET provider, the order of the parameters in the collection might be important. The and providers associate the parameters in the collection according to the order in which the parameters appear in the parameterized SQL query. The provider, which is the default ADO.NET provider for the control, associates the parameters in the collection by matching the name of the parameter with a placeholder alias in the SQL query. For more information on parameterized SQL queries and commands, see Using Parameters with the SqlDataSource Control.

  Gets the parameters collection containing the parameters that are used by the property.

  2.0.0.0
- Property
  System.Boolean To be added. To be added.

  Gets a value indicating whether the object is saving changes to its view state.

  2.0.0.0
- Method
  System.Void ``

  This method is primarily used by the dnprdnshort infrastructure and is not intended to be used directly from your code. However, control developers can override this method to specify how a custom server control restores its view state. For more information, see ASP.NET State Management Overview.

  The method restores view-state information for the object from a previous page request that was saved by the method.

  Restores the previously saved view state for the data source view.

  An object that represents the state to restore. 2.0.0.0
- Property
  System.ComponentModel.DefaultValue("{0}")
  System.String To be added.

  The format string is applied to primary keys only, such as those that are identified by the DataKeyNames property of the data-bound control or in delete and update scenarios where the property is set to the value and a set of is passed to the corresponding data method. In this case, the format string is applied to each parameter name in the collection. For more information, see .

  The value of the property is stored in view state.

  Gets or sets a format string to apply to the names of any parameters that are passed to the or method.

  2.0.0.0
- Method
  System.Void ``

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

  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 after the control has completed a delete operation.

  A that contains the event data. 2.0.0.0
- Method
  System.Void ``

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

  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 before the control attempts a delete operation.

  A that contains the event data. 2.0.0.0
- Method
  System.Void ``

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

  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 before the control filters the results of a select operation.

  A that contains the event data. 2.0.0.0
- Method
  System.Void ``

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

  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 after the control has completed an insert operation.

  A that contains the event data. 2.0.0.0
- Method
  System.Void ``

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

  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 before the control attempts an insert operation.

  A that contains the event data. 2.0.0.0
- Method
  System.Void ``

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

  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 after the control has completed a data retrieval operation.

  A that contains the event data. 2.0.0.0
- Method
  System.Void ``

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

  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 before the control attempts a data retrieval operation.

  A that contains the event data. 2.0.0.0
- Method
  System.Void ``

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

  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 after the control has completed an update operation.

  A that contains the event data. 2.0.0.0
- Method
  System.Void ``

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

  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 before the control attempts an update operation.

  A that contains the event data. 2.0.0.0
- Property
  System.String To be added.

  SQL queries and commands can be parameterized, in that they contain placeholders for values that are bound to the query at run time. Depending on the ADO.NET provider that is set for the control, which is identified by the property, the parameters are evaluated by alias or by their ordering in the object.

  If the is not set or is set to the , parameters are evaluated by alias and the property is used to add a parameter prefix to the property of each object in a during a data retrieval or data manipulation operation. If the property is set to the or , the parameters are evaluated by order and the and properties are ignored.

  If you extend the class, you can override the property to supply a prefix other than the "@" string, if required.

  Gets the string that is used to prefix a parameter placeholder in a parameterized SQL query.

  2.0.0.0
- Method
  System.Object

  The method is primarily used by control developers.

  View state is the accumulation of the values of the properties for a server control. These values are automatically placed in the property for the server control, which is an instance of the class. The value for the server control is then persisted to a string object after the save state stage of the server control life cycle.

  When view state is saved, the string object that was persisted after the save state stage of the server control life cycle is returned to the client as a variable that is stored in an HTML Hidden element. When you author custom server controls, you can improve efficiency by overriding the method and modifying the ViewState property for your server control. For more information, see ASP.NET State Management Overview.

  Saves the changes to the view state for the control since the time that the page was posted back to the server.

  The object that contains the changes to the view state; otherwise, null, if there is no view state associated with the object.

  2.0.0.0
- Method
  System.Collections.IEnumerable ``

  The method calls the method, passing the parameter.

  The method returns a object, if the property is set to the value or it returns a object, if the property is set to the value. Close the object when you have finished reading the data.

  Retrieves data from the underlying database using the SQL string and any parameters that are in the collection.

  An list of data rows.

  A used to request operations on the data beyond basic data retrieval. 2.0.0.0
- Property
  System.String To be added.

  Because different database products use different varieties of SQL, the syntax of the SQL string depends on the current ADO.NET provider being used, which is identified by the property. If the SQL string is a parameterized query or command, the placeholder of the parameter also depends on the ADO.NET provider being used. For example, if the provider is the , which is the default provider for the class, the placeholder of the parameter is '@parameterName'. However, if the provider is set to the or , the placeholder of the parameter is '?'. For more information on parameterized SQL queries and commands, see Using Parameters with the SqlDataSource Control.

  The property can be an SQL string or the name of a stored procedure, if the data source supports stored procedures.

  It is more secure to use a stored procedure than a SQL statement for the property.

  The value of the property is stored in view state.

  Gets or sets the SQL string that the object uses to retrieve data from the underlying database.

  2.0.0.0
- Property
  System.Web.UI.WebControls.SqlDataSourceCommandType To be added.

  The value of the property is stored in view state.

  Gets or sets a value indicating whether the text in the property is a SQL query or the name of a stored procedure.

  2.0.0.0
- Event
  System.Web.UI.WebControls.SqlDataSourceStatusEventHandler

  Handle the event to examine the values of output parameters after a data retrieval operation has completed. The output parameters are available from the object that is associated with the event.

  For more information about handling events, see Consuming Events.

  Occurs when a data retrieval operation has completed.

  2.0.0.0
- Event
  System.Web.UI.WebControls.SqlDataSourceSelectingEventHandler

  Handle the event to perform additional initialization operations that are specific to your application, to validate the values of parameters, or to change the parameter values before the control performs the data retrieval operation.

  For more information about handling events, see Consuming Events.

  Occurs before a data retrieval operation.

  2.0.0.0
- Property
  System.Web.UI.WebControls.ParameterCollection To be added.

  If the property contains a parameterized SQL query, the collection contains any objects that correspond to the parameter placeholders in the SQL string.

  Depending on the ADO.NET provider, the order of the parameters in the collection might be important. The and providers associate the parameters in the collection according to the order in which the parameters appear in the parameterized SQL query. The provider, which is the default ADO.NET provider for the control, associates the parameters in the collection by matching the name of the parameter with a placeholder alias in the SQL query. For more information on parameterized SQL queries and commands, see Using Parameters with the SqlDataSource Control.

  Gets the parameters collection containing the parameters that are used by the property.

  2.0.0.0
- Property
  System.String To be added.

  The property is evaluated only when the SQL command that is contained by the property is the name of a stored procedure. In this case, if the property is set, it contains the name of a parameter that is used to sort the results of the stored procedure.

  If the property is set, it is prepended to the property.

  The value of the property is stored in view state.

  Gets or sets the name of a stored procedure parameter that is used to sort retrieved data when data retrieval is performed using a stored procedure.

  2.0.0.0
- Property
  2.0.0.0
  System.Boolean To be added.

  This member is an explicit interface member implementation. It can be used only when the instance is cast to the interface.

  For a description of this member, see .

- Method
  2.0.0.0
  System.Void ``

  This member is an explicit interface member implementation. It can be used only when the instance is cast to the interface.

  For a description of this member, see .

  An object that represents the state to restore.
- Method
  2.0.0.0
  System.Object

  This member is an explicit interface member implementation. It can be used only when the instance is cast to the interface.

  For a description of this member, see .

  The object that contains the changes to the view state; otherwise, null, if there is no view state associated with the object.

- Method
  2.0.0.0
  System.Void

  This member is an explicit interface member implementation. It can be used only when the instance is cast to the interface.

  For a description of this member, see .

- Method
  System.Void To be added.

  Causes the object to track changes to its view state so that the changes can be stored in the object for the control and persisted across requests for the same page.

  2.0.0.0
- Method
  System.Int32 `` `` ``

  The method calls the method, passing the , , and parameters. For more information, see .

  Performs an update operation using the SQL string, any parameters that are in the collection, and the values that are in the specified , , and collections.

  A value that represents the number of rows updated in the underlying database.

  An of primary keys to use with the property to perform the update database operation. If there are no keys associated with the query or if the is not a parameterized SQL query, pass null. An of values to use with the property to perform the update database operation. If there are no parameters associated with the query or if the is not a parameterized SQL query, pass null. An that represents the original values in the database. If there are no parameters associated with the query or if the is not a parameterized SQL query, pass null. 2.0.0.0
- Property
  System.String To be added.

  Because different database products use different varieties of SQL, the syntax of the SQL string depends on the current ADO.NET provider being used, which is identified by the property. If the SQL string is a parameterized query or command, the placeholder of the parameter also depends on the ADO.NET provider being used. For example, if the provider is the , which is the default provider for the class, the placeholder of the parameter is '@parameterName'. However, if the provider is set to the or , the placeholder of the parameter is '?'. For more information on parameterized SQL queries and commands, see Using Parameters with the SqlDataSource Control.

  The property can be an SQL string or the name of a stored procedure, if the data source supports stored procedures.

  The value of the property is stored in view state.

  Gets or sets the SQL string that the object uses to update data in the underlying database.

  2.0.0.0
- Property
  System.Web.UI.WebControls.SqlDataSourceCommandType To be added.

  The value of the property is stored in view state.

  Gets or sets a value indicating whether the text in the property is a SQL statement or the name of a stored procedure.

  2.0.0.0
- Event
  System.Web.UI.WebControls.SqlDataSourceStatusEventHandler

  Handle the event to examine the values of output parameters after an update operation has completed. The output parameters are available from the object that is associated with the event.

  For more information about handling events, see Consuming Events.

  Occurs when an update operation has completed.

  2.0.0.0
- Property
  System.ComponentModel.DefaultValue(null)
  System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)
  System.ComponentModel.Editor("System.Web.UI.Design.WebControls.ParameterCollectionEditor, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.Drawing.Design.UITypeEditor, System.Drawing, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")
  System.Web.UI.WebControls.ParameterCollection To be added.

  If the property contains a parameterized SQL query, the collection contains any objects that correspond to the parameter placeholders that are in the SQL string.

  Parameter names might be affected by the property; specifically, if the name identifies a primary key, such as a key that is specified using the DataKeyNames property, or in delete and update scenarios where the property is set to the value, and a set of are passed to the corresponding data method. In this case, the format string is applied to each parameter name in the collection.

  Depending on the ADO.NET provider, the order of the parameters in the collection might be important. The and providers associate the parameters in the collection according to the order in which the parameters appear in the parameterized SQL query. The provider, which is the default ADO.NET provider for the control, associates the parameters in the collection by matching the name of the parameter with a placeholder alias in the SQL query. For more information on parameterized SQL queries and commands, see Using Parameters with the SqlDataSource Control.

  Gets the parameters collection containing the parameters that are used by the property.

  2.0.0.0
- Event
  System.Web.UI.WebControls.SqlDataSourceCommandEventHandler

  Handle the event to perform additional initialization operations that are specific to your application, to validate the values of parameters, or to change the parameter values before the control performs the update operation.

  The connection to the underlying data source is not yet open when the event handler delegate is called. Therefore, you cannot cancel the operation directly by calling the method on the object that is exposed by the object. You can, however, cancel the database operation by setting the property of the to true.

  For more information about handling events, see Consuming Events.

  Occurs before an update operation.

  2.0.0.0