SqlDataSource, classe (System.Web.UI.WebControls)

Réduire tout

Filtre de language

Affichage du contenu : côte à côte

.NET Framework Class Library

SqlDataSource Class

Represents an SQL database to data-bound controls.

Inheritance Hierarchy

System..::.Object
  System.Web.UI..::.Control
    System.Web.UI..::.DataSourceControl
      System.Web.UI.WebControls..::.SqlDataSource
        System.Web.UI.WebControls..::.AccessDataSource

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

Syntax

Visual Basic

<ToolboxBitmapAttribute(GetType(SqlDataSource))> _
Public Class SqlDataSource _
    Inherits DataSourceControl

[ToolboxBitmapAttribute(typeof(SqlDataSource))]
public class SqlDataSource : DataSourceControl

Visual C++

[ToolboxBitmapAttribute(typeof(SqlDataSource))]
public ref class SqlDataSource : public DataSourceControl

[<ToolboxBitmapAttribute(typeof(SqlDataSource))>]
type SqlDataSource =  
    class
        inherit DataSourceControl
    end

ASP.NET

<asp:SqlDataSource />

The SqlDataSource type exposes the following members.

Constructors

	Name	Description
	SqlDataSource()()()	Initializes a new instance of the SqlDataSource class.
	SqlDataSource(String, String)	Initializes a new instance of the SqlDataSource class with the specified connection string and Select command.
	SqlDataSource(String, String, String)	Initializes a new instance of the SqlDataSource class with the specified connection string and Select command.

Top

Properties

	Name	Description
	Adapter	Gets the browser-specific adapter for the control. (Inherited from Control.)
	AppRelativeTemplateSourceDirectory	Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control. (Inherited from Control.)
	BindingContainer	Infrastructure. Gets the control that contains this control's data binding. (Inherited from Control.)
	CacheDuration	Gets or sets the length of time, in seconds, that the data source control caches data that is retrieved by the Select method.
	CacheExpirationPolicy	Gets or sets the cache expiration behavior that, when combined with the duration, describes the behavior of the cache that the data source control uses.
	CacheKeyDependency	Gets or sets a user-defined key dependency that is linked to all data cache objects that are created by the data source control. All cache objects are explicitly expired when the key is expired.
	CancelSelectOnNullParameter	Gets or sets a value indicating whether a data retrieval operation is canceled when any parameter that is contained in the SelectParameters collection evaluates to nullNothingnullptra null reference (Nothing in Visual Basic).
	ChildControlsCreated	Gets a value that indicates whether the server control's child controls have been created. (Inherited from Control.)
	ClientID	Gets the server control identifier generated by ASP.NET. (Inherited from DataSourceControl.)
	ClientIDMode	This property is not used for data source controls. (Inherited from DataSourceControl.)
	ClientIDSeparator	Gets a character value representing the separator character used in the ClientID property. (Inherited from Control.)
	ConflictDetection	Gets or sets the value indicating how the SqlDataSource control performs updates and deletes when data in a row in the underlying database changes during the time of the operation.
	ConnectionString	Gets or sets the ADO.NET provider–specific connection string that the SqlDataSource control uses to connect to an underlying database.
	Context	Gets the HttpContext object associated with the server control for the current Web request. (Inherited from Control.)
	Controls	Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy. (Inherited from DataSourceControl.)
	DataItemContainer	Gets a reference to the naming container if the naming container implements IDataItemContainer. (Inherited from Control.)
	DataKeysContainer	Gets a reference to the naming container if the naming container implements IDataKeysControl. (Inherited from Control.)
	DataSourceMode	Gets or sets the data retrieval mode that the SqlDataSource control uses to fetch data.
	DeleteCommand	Gets or sets the SQL string that the SqlDataSource control uses to delete data from the underlying database.
	DeleteCommandType	Gets or sets a value indicating whether the text in the DeleteCommand property is an SQL statement or the name of a stored procedure.
	DeleteParameters	Gets the parameters collection that contains the parameters that are used by the DeleteCommand property from the SqlDataSourceView object that is associated with the SqlDataSource control.
	DesignMode	Gets a value indicating whether a control is being used on a design surface. (Inherited from Control.)
	EnableCaching	Gets or sets a value indicating whether the SqlDataSource control has data caching enabled.
	EnableTheming	Gets a value indicating whether this control supports themes. (Inherited from DataSourceControl.)
	EnableViewState	Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client. (Inherited from Control.)
	Events	Gets a list of event handler delegates for the control. This property is read-only. (Inherited from Control.)
	FilterExpression	Gets or sets a filtering expression that is applied when the Select method is called.
	FilterParameters	Gets a collection of parameters that are associated with any parameter placeholders that are in the FilterExpression string.
	HasChildViewState	Gets a value indicating whether the current server control's child controls have any saved view-state settings. (Inherited from Control.)
	ID	Gets or sets the programmatic identifier assigned to the server control. (Inherited from Control.)
	IdSeparator	Infrastructure. Gets the character used to separate control identifiers. (Inherited from Control.)
	InsertCommand	Gets or sets the SQL string that the SqlDataSource control uses to insert data into the underlying database.
	InsertCommandType	Gets or sets a value indicating whether the text in the InsertCommand property is an SQL statement or the name of a stored procedure.
	InsertParameters	Gets the parameters collection that contains the parameters that are used by the InsertCommand property from the SqlDataSourceView object that is associated with the SqlDataSource control.
	IsChildControlStateCleared	Gets a value indicating whether controls contained within this control have control state. (Inherited from Control.)
	IsTrackingViewState	Gets a value that indicates whether the server control is saving changes to its view state. (Inherited from Control.)
	IsViewStateEnabled	Gets a value indicating whether view state is enabled for this control. (Inherited from Control.)
	LoadViewStateByID	Gets a value indicating whether the control participates in loading its view state by ID instead of index. (Inherited from Control.)
	NamingContainer	Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same Control..::.ID property value. (Inherited from Control.)
	OldValuesParameterFormatString	Gets or sets a format string to apply to the names of any parameters that are passed to the Delete or Update method.
	Page	Gets a reference to the Page instance that contains the server control. (Inherited from Control.)
	Parent	Gets a reference to the server control's parent control in the page control hierarchy. (Inherited from Control.)
	ProviderName	Gets or sets the name of the .NET Framework data provider that the SqlDataSource control uses to connect to an underlying data source.
	RenderingCompatibility	Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with. (Inherited from Control.)
	SelectCommand	Gets or sets the SQL string that the SqlDataSource control uses to retrieve data from the underlying database.
	SelectCommandType	Gets or sets a value indicating whether the text in the SelectCommand property is an SQL query or the name of a stored procedure.
	SelectParameters	Gets the parameters collection that contains the parameters that are used by the SelectCommand property from the SqlDataSourceView object that is associated with the SqlDataSource control.
	Site	Gets information about the container that hosts the current control when rendered on a design surface. (Inherited from Control.)
	SkinID	Gets the skin to apply to the DataSourceControl control. (Inherited from DataSourceControl.)
	SortParameterName	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.
	SqlCacheDependency	Gets or sets a semicolon-delimited string that indicates which databases and tables to use for the Microsoft SQL Server cache dependency.
	TemplateControl	Gets or sets a reference to the template that contains this control. (Inherited from Control.)
	TemplateSourceDirectory	Gets the virtual directory of the Page or UserControl that contains the current server control. (Inherited from Control.)
	UniqueID	Gets the unique, hierarchically qualified identifier for the server control. (Inherited from Control.)
	UpdateCommand	Gets or sets the SQL string that the SqlDataSource control uses to update data in the underlying database.
	UpdateCommandType	Gets or sets a value indicating whether the text in the UpdateCommand property is an SQL statement or the name of a stored procedure.
	UpdateParameters	Gets the parameters collection that contains the parameters that are used by the UpdateCommand property from the SqlDataSourceView control that is associated with the SqlDataSource control.
	ViewState	Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page. (Inherited from Control.)
	ViewStateIgnoresCase	Gets a value that indicates whether the StateBag object is case-insensitive. (Inherited from Control.)
	ViewStateMode	Gets or sets the view-state mode of this control. (Inherited from Control.)
	Visible	Gets or sets a value indicating whether the control is visually displayed. (Inherited from DataSourceControl.)

Top

Methods

	Name	Description
	AddedControl	Called after a child control is added to the Controls collection of the Control object. (Inherited from Control.)
	AddParsedSubObject	Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object. (Inherited from Control.)
	ApplyStyleSheetSkin	Applies the style properties that are defined in the page style sheet to the control. (Inherited from DataSourceControl.)
	BuildProfileTree	Infrastructure. Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page. (Inherited from Control.)
	ClearCachedClientID	Infrastructure. Sets the cached ClientID value to nullNothingnullptra null reference (Nothing in Visual Basic). (Inherited from Control.)
	ClearChildControlState	Deletes the control-state information for the server control's child controls. (Inherited from Control.)
	ClearChildState	Deletes the view-state and control-state information for all the server control's child controls. (Inherited from Control.)
	ClearChildViewState	Deletes the view-state information for all the server control's child controls. (Inherited from Control.)
	ClearEffectiveClientIDMode	Infrastructure. Sets the ClientIDMode property of the current control instance and of any child controls to Inherit. (Inherited from Control.)
	CreateChildControls	Called by the ASP.NET page framework to notify server controls that use composition-based implementation to create any child controls they contain in preparation for posting back or rendering. (Inherited from Control.)
	CreateControlCollection	Creates a collection to store child controls. (Inherited from DataSourceControl.)
	CreateDataSourceView	Creates a data source view object that is associated with the data source control.
	DataBind()()()	Binds a data source to the invoked server control and all its child controls. (Inherited from Control.)
	DataBind(Boolean)	Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event. (Inherited from Control.)
	DataBindChildren	Binds a data source to the server control's child controls. (Inherited from Control.)
	Delete	Performs a delete operation using the DeleteCommand SQL string and any parameters that are in the DeleteParameters collection.
	Dispose	Enables a server control to perform final clean up before it is released from memory. (Inherited from Control.)
	EnsureChildControls	Determines whether the server control contains child controls. If it does not, it creates child controls. (Inherited from Control.)
	EnsureID	Creates an identifier for controls that do not have an identifier assigned. (Inherited from Control.)
	Equals(Object)	Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
	FindControl(String)	Searches the current naming container for a server control with the specified id parameter. (Inherited from DataSourceControl.)
	FindControl(String, Int32)	Infrastructure. Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. You should not override this version of the FindControl method. (Inherited from Control.)
	Focus	Sets input focus to the control. (Inherited from DataSourceControl.)
	GetDbProviderFactory	Returns the DbProviderFactory object that is associated with the ADO.NET provider that is identified by the ProviderName property.
	GetDesignModeState	Infrastructure. Gets design-time data for a control. (Inherited from Control.)
	GetHashCode	Serves as a hash function for a particular type. (Inherited from Object.)
	GetRouteUrl(Object)	Gets the URL that corresponds to a set of route parameters. (Inherited from Control.)
	GetRouteUrl(RouteValueDictionary)	Gets the URL that corresponds to a set of route parameters. (Inherited from Control.)
	GetRouteUrl(String, Object)	Gets the URL that corresponds to a set of route parameters and a route name. (Inherited from Control.)
	GetRouteUrl(String, RouteValueDictionary)	Gets the URL that corresponds to a set of route parameters and a route name. (Inherited from Control.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	GetUniqueIDRelativeTo	Returns the prefixed portion of the UniqueID property of the specified control. (Inherited from Control.)
	GetView	Gets the named data source view that is associated with the data source control. (Overrides DataSourceControl..::.GetView(String).)
	GetViewNames	Gets a collection of names representing the list of view objects that are associated with the SqlDataSource control. (Overrides DataSourceControl..::.GetViewNames()()().)
	HasControls	Determines if the server control contains any child controls. (Inherited from DataSourceControl.)
	HasEvents	Returns a value indicating whether events are registered for the control or any child controls. (Inherited from Control.)
	Insert	Performs an insert operation using the InsertCommand SQL string and any parameters that are in the InsertParameters collection.
	IsLiteralContent	Infrastructure. Determines if the server control holds only literal content. (Inherited from Control.)
	LoadControlState	Restores control-state information from a previous page request that was saved by the SaveControlState method. (Inherited from Control.)
	LoadViewState	Infrastructure. Loads the state of the properties in the SqlDataSource control that need to be persisted. (Overrides Control..::.LoadViewState(Object).)
	MapPathSecure	Retrieves the physical path that a virtual path, either absolute or relative, maps to. (Inherited from Control.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	OnBubbleEvent	Determines whether the event for the server control is passed up the page's UI server control hierarchy. (Inherited from Control.)
	OnDataBinding	Raises the DataBinding event. (Inherited from Control.)
	OnInit	Adds a LoadComplete event handler to the Page control that contains the SqlDataSource control. (Overrides Control..::.OnInit(EventArgs).)
	OnLoad	Raises the Load event. (Inherited from Control.)
	OnPreRender	Raises the PreRender event. (Inherited from Control.)
	OnUnload	Raises the Unload event. (Inherited from Control.)
	OpenFile	Gets a Stream used to read a file. (Inherited from Control.)
	RaiseBubbleEvent	Assigns any sources of the event and its information to the control's parent. (Inherited from Control.)
	RaiseDataSourceChangedEvent	Raises the DataSourceChanged event. (Inherited from DataSourceControl.)
	RemovedControl	Called after a child control is removed from the Controls collection of the Control object. (Inherited from Control.)
	Render	Sends server control content to a provided HtmlTextWriter object, which writes the content to be rendered on the client. (Inherited from Control.)
	RenderChildren	Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client. (Inherited from Control.)
	RenderControl(HtmlTextWriter)	Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled. (Inherited from DataSourceControl.)
	RenderControl(HtmlTextWriter, ControlAdapter)	Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object. (Inherited from Control.)
	ResolveAdapter	Gets the control adapter responsible for rendering the specified control. (Inherited from Control.)
	ResolveClientUrl	Gets a URL that can be used by the browser. (Inherited from Control.)
	ResolveUrl	Converts a URL into one that is usable on the requesting client. (Inherited from Control.)
	SaveControlState	Saves any server control state changes that have occurred since the time the page was posted back to the server. (Inherited from Control.)
	SaveViewState	Infrastructure. Saves the current view state of the SqlDataSource control. (Overrides Control..::.SaveViewState()()().)
	Select	Retrieves data from the underlying database by using the SelectCommand SQL string and any parameters that are in the SelectParameters collection.
	SetDesignModeState	Sets design-time data for a control. (Inherited from Control.)
	SetRenderMethodDelegate	Infrastructure. Assigns an event handler delegate to render the server control and its content into its parent control. (Inherited from Control.)
	ToString	Returns a string that represents the current object. (Inherited from Object.)
	TrackViewState	Infrastructure. Tracks view state changes to the SqlDataSource control so that the changes can be stored in the System.Web.UI..::.StateBag object for the control. (Overrides Control..::.TrackViewState()()().)
	Update	Performs an update operation using the UpdateCommand SQL string and any parameters that are in the UpdateParameters collection.

Top

Events

	Name	Description
	DataBinding	Occurs when the server control binds to a data source. (Inherited from Control.)
	Deleted	Occurs when a delete operation has completed.
	Deleting	Occurs before a delete operation.
	Disposed	Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested. (Inherited from Control.)
	Filtering	Occurs before a filter operation.
	Init	Occurs when the server control is initialized, which is the first step in its lifecycle. (Inherited from Control.)
	Inserted	Occurs when an insert operation has completed.
	Inserting	Occurs before an insert operation.
	Load	Occurs when the server control is loaded into the Page object. (Inherited from Control.)
	PreRender	Occurs after the Control object is loaded but prior to rendering. (Inherited from Control.)
	Selected	Occurs when a data retrieval operation has completed.
	Selecting	Occurs before a data retrieval operation.
	Unload	Occurs when the server control is unloaded from memory. (Inherited from Control.)
	Updated	Occurs when an update operation has completed.
	Updating	Occurs before an update operation.

Top

Extension Methods

	Name	Description
	FindDataSourceControl	Returns the data source that is associated with the data control for the specified control. (Defined by DynamicDataExtensions.)
	FindFieldTemplate	Returns the field template for the specified column in the specified control's naming container. (Defined by DynamicDataExtensions.)
	FindMetaTable	Returns the metatable object for the containing data control. (Defined by DynamicDataExtensions.)

Top

Explicit Interface Implementations

Top

Remarks

In this topic:

Introduction
Data Connections
Performing Data Operations
Data Provider
Caching
Additional Features
Data Source View
Declarative Syntax

Introduction

The SqlDataSource data source control represents data in an SQL relational database to data-bound controls. You can use the SqlDataSource control in conjunction with a data-bound control to retrieve data from a relational database and to display, edit, and sort data on a Web page with little or no code.

Data Connections

To connect to a database, you must set the ConnectionString property to a valid connection string. The SqlDataSource can support any SQL relational database that can be connected to using an ADO.NET provider, such as the SqlClient, OleDb, Odbc, or OracleClient provider. For information about how to secure connection strings, see How To: Secure Connection Strings when Using Data Source Controls.

To retrieve data from an underlying database, set the SelectCommand property with an SQL query. If the database that the SqlDataSource is associated with supports stored procedures, you can set the SelectCommand property to the name of a stored procedure. The SQL query that you specify can also be a parameterized query. You can add Parameter objects that are associated with a parameterized query to the SelectParameters collection. For more information about parameterized SQL queries and their syntax, see Using Parameters with Data Source Controls.

The SqlDataSource control retrieves data whenever the Select method is called. This method provides programmatic access to the method that is specified by SelectMethod property. The Select method is automatically called by controls that are bound to the SqlDataSource when their DataBind method is called. If you set the DataSourceID property of a data-bound control, the control automatically binds to data from the data source, as required. Setting the DataSourceID property is the recommended method for binding an ObjectDataSource control to a data-bound control. Alternatively, you can use the DataSource property, but then you must explicitly call the DataBind method of the data-bound control. Some examples of data-bound controls that can use SqlDataSource are DataGrid, DetailsView, DataList, and DropDownList. You can call the Select method programmatically at any time to retrieve data from the underlying database.

In declarative and programmatic ASP.NET scenarios, you can set the DataSourceID property of the data-bound control to the ID of the SqlDataSource. You can also assign an instance of the SqlDataSource class to the DataSource property of the data-bound control. For more information about binding data-bound control to data source controls, see ASP.NET Data Access Overview.

Performing Data Operations

Depending on the capabilities of the underlying database product and the configuration of the instance of the SqlDataSource class, you can perform data operations, such as updates, inserts, and deletes. To perform these data operations, set the appropriate command text and any associated parameters for the operation that you want to perform. For example, for an update operation, set the UpdateCommand property to an SQL string or the name of a stored procedure and add any required parameters to the UpdateParameters collection. The update is performed when the Update method is called, either explicitly by your code or automatically by a data-bound control. The same general pattern is followed for Delete and Insert operations.

The SQL queries and commands that you use in the SelectCommand, UpdateCommand, InsertCommand, and DeleteCommand properties can be parameterized. This means that the query or command can use placeholders instead of literal values and bind the placeholders to application or user-defined variables. You can bind parameters in SQL queries to Session variables, values that are passed on the query string for a Web Forms page, the property values of other server controls, and more. For more information about how to use parameters in SQL queries with the SqlDataSource, see Using Parameters with Data Source Controls and Using Parameters with the SqlDataSource Control.

Note
By default, if one of the parameters is nullNothingnullptra null reference (Nothing in Visual Basic) when you execute a Select command, no data will be returned and no exception will be thrown. You can change this behavior by setting the CancelSelectOnNullParameter property to false.

Data Provider

By default, the SqlDataSource control works with the .NET Framework Data Provider for SQL Server, but SqlDataSource is not Microsoft SQL Server–specific. You can connect the SqlDataSource control with any database product for which there is a managed ADO.NET provider. When used with the System.Data.OleDb provider, the SqlDataSource can work with any OLE DB-compliant database. When used with the System.Data.Odbc provider, the SqlDataSource can be used with any ODBC driver and database, including IBM DB2, MySQL, and PostgreSQL. When used with the System.Data.OracleClient provider, the SqlDataSource can work with Oracle 8.1.7 databases and later. The list of allowable providers is registered in the DbProviderFactories section of the configuration file, either in the Machine.config or Web.config file. For more information, see Selecting Data Using the SqlDataSource Control.

Caching

If you display data on your page using a SqlDataSource control, you can increase the performance of the page by using the data caching capabilities of the data source control. Caching reduces the processing load on the database servers at the expense of memory on the Web server; in most cases, this is a good trade-off. The SqlDataSource automatically caches data when the EnableCaching property is set to true and the CacheDuration property is set to the number of seconds that the cache stores data before the cache entry is discarded. You can also specify a CacheExpirationPolicy and an optional SqlCacheDependency value.

Additional Features

The SqlDataSource provides additional capabilities, as listed in the following table.

Capability	Requirements
Caching	Set the DataSourceMode property to the DataSet value, the EnableCaching property to true, and the CacheDuration and CacheExpirationPolicy properties according to the caching behavior you want for your cached data.
Deleting	Set the DeleteCommand property to an SQL statement used to delete data. This statement is typically parameterized.
Filtering	Set the DataSourceMode property to the DataSet value. Set the FilterExpression property to a filtering expression used to filter the data when the Select method is called.
Inserting	Set the InsertCommand property to an SQL statement used to insert data. This statement is typically parameterized.
Paging	Not currently supported by the SqlDataSource, however some data-bound controls, such as GridView, support paging when you set the DataSourceMode property to the DataSet value.
Selecting	Set the SelectCommand property to an SQL statement used to retrieve data.
Sorting	Set the DataSourceMode property to DataSet.
Updating	Set the UpdateCommand property to an SQL statement used to update data. This statement is typically parameterized.

Data Source View

As with all data source controls, the SqlDataSource control is associated with a data source view class. The SqlDataSource control has only one associated SqlDataSourceView, and it is always named Table.

There is no visual rendering of the SqlDataSource control; it is implemented as a control so that you can create it declaratively and, optionally, to allow it to participate in state management. As a result, the SqlDataSource does not support visual features, such as the ones that are provided by the EnableTheming or SkinID property.

Declarative Syntax

<asp:SqlDataSource
    CacheDuration="string|Infinite"
    CacheExpirationPolicy="Absolute|Sliding"
    CacheKeyDependency="string"
    CancelSelectOnNullParameter="True|False"
    ConflictDetection="OverwriteChanges|CompareAllValues"
    ConnectionString="string"
    DataSourceMode="DataReader|DataSet"
    DeleteCommand="string"
    DeleteCommandType="Text|StoredProcedure"
    EnableCaching="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    FilterExpression="string"
    ID="string"
    InsertCommand="string"
    InsertCommandType="Text|StoredProcedure"
    OldValuesParameterFormatString="string"
    OnDataBinding="DataBinding event handler"
    OnDeleted="Deleted event handler"
    OnDeleting="Deleting event handler"
    OnDisposed="Disposed event handler"
    OnFiltering="Filtering event handler"
    OnInit="Init event handler"
    OnInserted="Inserted event handler"
    OnInserting="Inserting event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnSelected="Selected event handler"
    OnSelecting="Selecting event handler"
    OnUnload="Unload event handler"
    OnUpdated="Updated event handler"
    OnUpdating="Updating event handler"
    ProviderName="string|System.Data.Odbc|System.Data.OleDb|
        System.Data.OracleClient|System.Data.SqlClient|
        Microsoft.SqlServerCe.Client"
    runat="server"
    SelectCommand="string"
    SelectCommandType="Text|StoredProcedure"
    SkinID="string"
    SortParameterName="string"
    SqlCacheDependency="string"
    UpdateCommand="string"
    UpdateCommandType="Text|StoredProcedure"
    Visible="True|False"
>
        <DeleteParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </DeleteParameters>
        <FilterParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </FilterParameters>
        <InsertParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </InsertParameters>
        <SelectParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </SelectParameters>
        <UpdateParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </UpdateParameters>
</asp:SqlDataSource>

Topic	Location
Comment : sécuriser des chaînes de connexion lors de l'utilisation de contrôles de source de données	Génération d'applications Web ASP.NET
Comment : sécuriser des chaînes de connexion lors de l'utilisation de contrôles de source de données	Génération d'applications Web ASP.NET dans Visual Studio
Comment : accéder à SQL Server à l'aide d'un utilisateur de domaine Windows mappé	Génération d'applications Web ASP.NET
Comment : accéder à SQL Server à l'aide d'un utilisateur de domaine Windows mappé	Génération d'applications Web ASP.NET dans Visual Studio
Comment : accéder à SQL Server en tant qu'utilisateur local	Génération d'applications Web ASP.NET
Comment : accéder à SQL Server en tant qu'utilisateur local	Génération d'applications Web ASP.NET dans Visual Studio
Comment : activer le filtrage pour des contrôles SqlDataSource (Visual Studio)	Génération d'applications Web ASP.NET dans Visual Studio
Comment : activer le filtrage pour le contrôle SqlDataSource	Génération d'applications Web ASP.NET
Comment : activer le filtrage pour le contrôle SqlDataSource	Génération d'applications Web ASP.NET dans Visual Studio
Comment : afficher les publicités d'une base de données à l'aide du contrôle serveur Web AdRotator	Génération d'applications Web ASP.NET
Comment : afficher les publicités d'une base de données à l'aide du contrôle serveur Web AdRotator	Génération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles serveur Web Repeater à une page Web Forms	Génération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles serveur Web Repeater à une page Web Forms (Visual Studio)	Génération d'applications Web ASP.NET dans Visual Studio
Comment : établir une connexion à une base de données Access à l'aide du contrôle SqlDataSource	Génération d'applications Web ASP.NET
Comment : établir une connexion à une base de données Access à l'aide du contrôle SqlDataSource (Visual Studio)	Génération d'applications Web ASP.NET dans Visual Studio
Comment : établir une connexion à une base de données Access à l'aide du contrôle SqlDataSource (Visual Studio)	Génération d'applications Web ASP.NET dans Visual Studio
Comment : établir une connexion à une base de données ODBC à l'aide du contrôle SqlDataSource	Génération d'applications Web ASP.NET
Comment : établir une connexion à une base de données ODBC à l'aide du contrôle SqlDataSource (Visual Studio)	Génération d'applications Web ASP.NET dans Visual Studio
Comment : établir une connexion à une base de données ODBC à l'aide du contrôle SqlDataSource (Visual Studio)	Génération d'applications Web ASP.NET dans Visual Studio
Comment : établir une connexion à une base de données Oracle à l'aide du contrôle SqlDataSource (Visual Studio)	Génération d'applications Web ASP.NET dans Visual Studio
Comment : établir une connexion à une base de données Oracle à l'aide du contrôle SqlDataSource (Visual Studio)	Génération d'applications Web ASP.NET dans Visual Studio
Comment : établir une connexion avec une base de données Oracle à l'aide du contrôle SqlDataSource	Génération d'applications Web ASP.NET
Comment : établir une liaison vers les données d'un contrôle basé sur des modèles	Génération d'applications Web ASP.NET
Comment : établir une liaison vers les données d'un contrôle basé sur des modèles	Génération d'applications Web ASP.NET dans Visual Studio
Comment : établir une liaison vers les données d'un contrôle basé sur des modèles dans Visual Studio	Génération d'applications Web ASP.NET dans Visual Studio
Comment : établir une liaison vers les données d'un contrôle basé sur des modèles dans Visual Studio	Génération d'applications Web ASP.NET dans Visual Studio
Comment : permettre aux utilisateurs de supprimer des éléments dans des contrôles serveur Web DataList	Génération d'applications Web ASP.NET
Comment : permettre aux utilisateurs de supprimer des éléments dans des contrôles serveur Web DataList	Génération d'applications Web ASP.NET dans Visual Studio
Comment : personnaliser des contrôles en vue d'une modification dans le contrôle serveur Web GridView	Génération d'applications Web ASP.NET dans Visual Studio
Comment : personnaliser des contrôles en vue d'une modification dans le contrôle serveur Web GridView	Génération d'applications Web ASP.NET dans Visual Studio
Comment : se connecter à une base de données SQL Server à l'aide du contrôle SqlDataSource	Génération d'applications Web ASP.NET
Comment : se connecter à une base de données SQL Server à l'aide du contrôle SqlDataSource (Visual Studio)	Génération d'applications Web ASP.NET dans Visual Studio
Comment : se connecter à une base de données SQL Server à l'aide du contrôle SqlDataSource (Visual Studio)	Génération d'applications Web ASP.NET dans Visual Studio
Comment : sécuriser des chaînes de connexion lors de l'utilisation de contrôles de source de données (Visual Studio)	Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : accès aux données de base dans les pages Web	Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : accès aux données de base dans les pages Web	Génération d'applications à l'aide de Visual Web Developer
Procédure pas à pas : affichage de données à l'aide d'une procédure stockée dans le contrôle serveur Web GridView	Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage de données à l'aide d'une procédure stockée dans le contrôle serveur Web GridView	Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage de données hiérarchiques dans un contrôle TreeView	Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage de données hiérarchiques dans un contrôle TreeView	Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage des données mises en forme dans les pages Web avec le contrôle serveur Web FormView	Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage des données mises en forme dans les pages Web avec le contrôle serveur Web FormView	Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage d'une liste déroulante tout en modifiant le contrôle serveur Web GridView	Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage d'une liste déroulante tout en modifiant le contrôle serveur Web GridView	Génération d'applications à l'aide de Visual Web Developer
Procédure pas à pas : affichage d'une liste déroulante tout en modifiant le contrôle serveur Web GridView	dv_vwdcon
Procédure pas à pas : affichage et mise en forme des données avec le contrôle serveur Web DataList	Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage et mise en forme des données avec le contrôle serveur Web DataList	Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création de pages Web maître/détail dans Visual Studio	Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création de pages Web maître/détail dans Visual Studio	Génération d'applications à l'aide de Visual Web Developer
Procédure pas à pas : modification et insertion de données dans les pages Web avec le contrôle serveur Web DetailsView	Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : modification et insertion de données dans les pages Web avec le contrôle serveur Web DetailsView	Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : tri simple pour le contrôle serveur Web GridView	Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : tri simple pour le contrôle serveur Web GridView	Génération d'applications Web ASP.NET dans Visual Studio

Examples

A Visual Studio Web site project with source code is available to accompany this topic: Download.

This section contains four code examples:

The first code example demonstrates how to display data from SQL Server in a GridView control using declarative syntax.
The second code example demonstrates how to display data from an ODBC-compliant database in a GridView control using declarative syntax.
The third code example demonstrates how to display and update data in a GridView control.
The fourth code example demonstrates how to display and update data in a DropDownList control.
Note
These examples show how to use declarative syntax for data access. For information about how to access data by using code instead of markup, see Accessing Data in Visual Studio.

The following code example demonstrates how to use a SqlDataSource control declaratively to retrieve data from SQL Server and display it in a GridView control.

Visual Basic

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html  >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataReader"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html  >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataReader"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>

The following code example demonstrates how to use a SqlDataSource control declaratively to retrieve data from an ODBC-compliant database and display it in a GridView control. The ProviderName property is the name of the .NET Framework Data Provider for ODBC, which is System.Data.Odbc.

Visual Basic

<%@Page  Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html  >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <!-- This example uses a Northwind database that is hosted by an ODBC-compliant
         database. To run this sample, create an ODBC DSN to any database that hosts
         the Northwind database, including Microsoft SQL Server or Microsoft Access,
         change the name of the DSN in the ConnectionString, and view the page.
    -->
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          ProviderName="System.Data.Odbc"
          DataSourceMode="DataReader"
          ConnectionString="dsn=myodbc3dsn;"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html  >

  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <!-- This example uses a Northwind database that is hosted by an ODBC-compliant
         database. To run this sample, create an ODBC DSN to any database that hosts
         the Northwind database, including Microsoft SQL Server or Microsoft Access,
         change the name of the DSN in the ConnectionString, and view the page.
    -->
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          ProviderName="System.Data.Odbc"
          DataSourceMode="DataReader"
          ConnectionString="dsn=myodbc3dsn;"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>

The following code example demonstrates a common display and update scenario with the GridView control. As with the previous examples, data from the Northwind database is displayed in the GridView control. Additionally, because an UpdateCommand property is specified and the AutoGenerateEditButton property is set to true, you can edit and update the records with no additional code. The GridView control automatically handles adding parameters to the UpdateParameters collection and calls the Update method when the Update button in the GridView control is clicked.

Visual Basic

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html  >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataSet"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT EmployeeID,FirstName,LastName,Title FROM Employees"
          UpdateCommand="Update Employees SET FirstName=@FirstName,LastName=@LastName,Title=@Title WHERE EmployeeID=@EmployeeID">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          AutoGenerateColumns="False"
          DataKeyNames="EmployeeID"
          AutoGenerateEditButton="True"
          DataSourceID="SqlDataSource1">
          <columns>
              <asp:BoundField HeaderText="First Name" DataField="FirstName" />
              <asp:BoundField HeaderText="Last Name" DataField="LastName" />
              <asp:BoundField HeaderText="Title" DataField="Title" />
          </columns>

      </asp:GridView>
    </form>
  </body>
</html>

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html  >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataSet"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT EmployeeID,FirstName,LastName,Title FROM Employees"
          UpdateCommand="Update Employees SET FirstName=@FirstName,LastName=@LastName,Title=@Title WHERE EmployeeID=@EmployeeID">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          AutoGenerateColumns="False"
          DataKeyNames="EmployeeID"
          AutoGenerateEditButton="True"
          DataSourceID="SqlDataSource1">
          <columns>
              <asp:BoundField HeaderText="First Name" DataField="FirstName" />
              <asp:BoundField HeaderText="Last Name" DataField="LastName" />
              <asp:BoundField HeaderText="Title" DataField="Title" />
          </columns>

      </asp:GridView>

    </form>
  </body>
</html>

The following code example demonstrates a common display and update scenario with the DropDownList and TextBox controls. The DropDownList control does not automatically add update parameters to the UpdateParameters collection nor call the Update method, so you must do so. The update parameters are specified declaratively and you can add an event handler to perform the Update operation when an event is raised.

Security Note
This example includes a text box that accepts user input, which is a potential security threat. By default, ASP.NET Web pages validate that user input does not include script or HTML elements. For more information, see Script Exploits Overview.

Visual Basic

<%@Page  Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

 Sub On_Click(ByVal source As Object, ByVal e As EventArgs)
    Try
        SqlDataSource1.Update()
    Catch except As Exception
        ' Handle the Exception.
    End Try

    Label2.Text="The record was updated successfully!"

 End Sub 'On_Click
</script>

<html  >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT EmployeeID, LastName, Address FROM Employees"
          UpdateCommand="UPDATE Employees SET Address=@Address WHERE EmployeeID=@EmployeeID">
          <UpdateParameters>
              <asp:ControlParameter Name="Address" ControlId="TextBox1" PropertyName="Text"/>
              <asp:ControlParameter Name="EmployeeID" ControlId="DropDownList1" PropertyName="SelectedValue"/>
          </UpdateParameters>
      </asp:SqlDataSource>

      <asp:DropDownList
          id="DropDownList1"
          runat="server"
          DataTextField="LastName"
          DataValueField="EmployeeID"
          DataSourceID="SqlDataSource1">
      </asp:DropDownList>

      <br />
      <asp:Label id="Label1" runat="server" Text="Enter a new address for the selected user."
        AssociatedControlID="TextBox1" />
      <asp:TextBox id="TextBox1" runat="server" />
      <asp:Button id="Submit" runat="server" Text="Submit" OnClick="On_Click" />

      <br /><asp:Label id="Label2" runat="server" Text="" />
    </form>
  </body>
</html>

<%@Page  Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
 private void On_Click(Object source, EventArgs e) {
    try {
        SqlDataSource1.Update();
    }
    catch (Exception except) {
        // Handle the Exception.
    }

    Label2.Text="The record was updated successfully!";
 }
</script>

<html  >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT EmployeeID, LastName, Address FROM Employees"
          UpdateCommand="UPDATE Employees SET Address=@Address WHERE EmployeeID=@EmployeeID">
          <UpdateParameters>
              <asp:ControlParameter Name="Address" ControlId="TextBox1" PropertyName="Text"/>
              <asp:ControlParameter Name="EmployeeID" ControlId="DropDownList1" PropertyName="SelectedValue"/>
          </UpdateParameters>
      </asp:SqlDataSource>

      <asp:DropDownList
          id="DropDownList1"
          runat="server"
          DataTextField="LastName"
          DataValueField="EmployeeID"
          DataSourceID="SqlDataSource1">
      </asp:DropDownList>

      <br />
      <asp:Label id="Label1" runat="server" Text="Enter a new address for the selected user."
        AssociatedControlID="TextBox1" />
      <asp:TextBox id="TextBox1" runat="server" />
      <asp:Button id="Submit" runat="server" Text="Submit" OnClick="On_Click" />

      <br /><asp:Label id="Label2" runat="server" Text="" />

    </form>
  </body>
</html>

Version Information

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role not supported), Windows Server 2003 SP2

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

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Reference

System.Web.UI.WebControls Namespace

SqlDataSourceView

AccessDataSource

DataSourceControl

Other Resources

Accessing Data in Visual Studio

ASP.NET Data Access Overview

Data Source Web Server Controls

SqlDataSource Web Server Control Overview

ASP.NET Page Life Cycle Overview

Bibliothèque de classes .NET Framework

SqlDataSource, classe

Représente une base de données SQL pour les contrôles liés aux données.

Hiérarchie d'héritage

System..::.Object
  System.Web.UI..::.Control
    System.Web.UI..::.DataSourceControl
      System.Web.UI.WebControls..::.SqlDataSource
        System.Web.UI.WebControls..::.AccessDataSource

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans System.Web.dll)

Syntaxe

Visual Basic

<ToolboxBitmapAttribute(GetType(SqlDataSource))> _
Public Class SqlDataSource _
    Inherits DataSourceControl

[ToolboxBitmapAttribute(typeof(SqlDataSource))]
public class SqlDataSource : DataSourceControl

VisualC++

[ToolboxBitmapAttribute(typeof(SqlDataSource))]
public ref class SqlDataSource : public DataSourceControl

[<ToolboxBitmapAttribute(typeof(SqlDataSource))>]
type SqlDataSource =  
    class
        inherit DataSourceControl
    end

ASP.NET

<asp:SqlDataSource />

Le type SqlDataSource expose les membres suivants.

Constructeurs

	Nom	Description
	SqlDataSource()()()	Initialise une nouvelle instance de la classe SqlDataSource.
	SqlDataSource(String, String)	Initialise une nouvelle instance de la classe SqlDataSource avec la chaîne de connexion spécifiée et la commande Select.
	SqlDataSource(String, String, String)	Initialise une nouvelle instance de la classe SqlDataSource avec la chaîne de connexion spécifiée et la commande Select.

Début

Propriétés

	Nom	Description
	Adapter	Obtient l'adaptateur spécifique au navigateur pour le contrôle. (Hérité de Control.)
	AppRelativeTemplateSourceDirectory	Obtient ou définit le répertoire virtuel relatif à l'application de l'objet Page ou UserControl qui contient ce contrôle. (Hérité de Control.)
	BindingContainer	Infrastructure. Obtient le contrôle qui contient la liaison de données de ce contrôle. (Hérité de Control.)
	CacheDuration	Obtient ou définit la durée, en secondes, de la mise en cache des données par le contrôle de source de données avant que celles-ci soient récupérées par la méthode Select.
	CacheExpirationPolicy	Obtient ou définit le comportement d'expiration du cache qui, lorsqu'il est associé à la durée, décrit le comportement du cache utilisé par le contrôle de source de données.
	CacheKeyDependency	Obtient ou définit une dépendance de clé définie par l'utilisateur qui est liée à tous les objets du cache de données créés par le contrôle de source de données. Tous les objets du cache expirent explicitement lorsque la clé expire.
	CancelSelectOnNullParameter	Obtient ou définit une valeur indiquant si une opération de récupération de données est annulée lorsque tout paramètre qui est contenu dans la collection SelectParameters est égal à nullNothingnullptrune référence null (Nothing en Visual Basic).
	ChildControlsCreated	Obtient une valeur qui indique si des contrôles enfants du contrôle serveur ont été créés. (Hérité de Control.)
	ClientID	Obtient l'identificateur de contrôle serveur généré par ASP.NET. (Hérité de DataSourceControl.)
	ClientIDMode	Cette propriété n'est pas utilisée pour les contrôles de source de données. (Hérité de DataSourceControl.)
	ClientIDSeparator	Obtient une valeur de caractère représentant le caractère de séparation utilisé dans la propriété ClientID. (Hérité de Control.)
	ConflictDetection	Obtient ou définit la valeur indiquant comment le contrôle SqlDataSource exécute des mises à jour et des suppressions lorsque des données dans une ligne de la base de données sous-jacente sont modifiées au cours de l'opération.
	ConnectionString	Obtient ou définit la chaîne de connexion spécifique au fournisseur ADO.NET que le contrôle SqlDataSource utilise pour se connecter à une base de données sous-jacente.
	Context	Obtient l'objet HttpContext associé au contrôle serveur pour la demande Web en cours. (Hérité de Control.)
	Controls	Obtient un objet ControlCollection qui représente les contrôles enfants d'un contrôle serveur spécifié dans la hiérarchie de l'interface utilisateur. (Hérité de DataSourceControl.)
	DataItemContainer	Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataItemContainer. (Hérité de Control.)
	DataKeysContainer	Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataKeysControl. (Hérité de Control.)
	DataSourceMode	Obtient ou définit le mode de récupération de données que le contrôle SqlDataSource utilise pour récupérer les données.
	DeleteCommand	Obtient ou définit la chaîne SQL que le contrôle SqlDataSource utilise pour supprimer des données de la base de données sous-jacente.
	DeleteCommandType	Obtient ou définit une valeur indiquant si le texte de la propriété DeleteCommand est une instruction SQL ou le nom d'une procédure stockée.
	DeleteParameters	Obtient la collection de paramètres qui contient les paramètres utilisés par la propriété DeleteCommand de l'objet SqlDataSourceView qui est associé au contrôle SqlDataSource.
	DesignMode	Obtient une valeur indiquant si un contrôle est utilisé sur une aire de conception. (Hérité de Control.)
	EnableCaching	Obtient ou définit une valeur indiquant si la mise en cache de données du contrôle SqlDataSource est activée.
	EnableTheming	Obtient une valeur indiquant si cet objet prend en charge des thèmes. (Hérité de DataSourceControl.)
	EnableViewState	Obtient ou définit une valeur indiquant si le contrôle serveur rend persistant son état d'affichage, ainsi que celui de tous les contrôles enfants qu'il contient, sur le client à l'origine de la demande. (Hérité de Control.)
	Events	Obtient la liste des délégués de gestionnaires d'événements pour le contrôle. Cette propriété est en lecture seule. (Hérité de Control.)
	FilterExpression	Obtient ou définit une expression de filtrage qui est appliquée lorsque la méthode Select est appelée.
	FilterParameters	Obtient une collection de paramètres qui sont associés aux espaces réservés des paramètres dans la chaîne FilterExpression.
	HasChildViewState	Obtient une valeur indiquant si les contrôles enfants du contrôle serveur en cours possèdent des paramètres d'état d'affichage enregistrés. (Hérité de Control.)
	ID	Obtient ou définit l'ID programmatique assigné au contrôle serveur. (Hérité de Control.)
	IdSeparator	Infrastructure. Obtient le caractère utilisé pour séparer des identificateurs de contrôle. (Hérité de Control.)
	InsertCommand	Obtient ou définit la chaîne SQL que le contrôle SqlDataSource utilise pour insérer des données dans la base de données sous-jacente.
	InsertCommandType	Obtient ou définit une valeur indiquant si le texte de la propriété InsertCommand est une instruction SQL ou le nom d'une procédure stockée.
	InsertParameters	Obtient la collection de paramètres qui contient les paramètres utilisés par la propriété InsertCommand de l'objet SqlDataSourceView qui est associé au contrôle SqlDataSource.
	IsChildControlStateCleared	Obtient une valeur indiquant si les contrôles contenus dans ce contrôle utilisent l'état du contrôle. (Hérité de Control.)
	IsTrackingViewState	Obtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d'affichage. (Hérité de Control.)
	IsViewStateEnabled	Obtient une valeur indiquant si l'état d'affichage est activé pour ce contrôle. (Hérité de Control.)
	LoadViewStateByID	Obtient une valeur indiquant si le contrôle participe au chargement de son état d'affichage par ID et non par index. (Hérité de Control.)
	NamingContainer	Obtient une référence au conteneur d'attribution de noms du contrôle serveur, qui crée un espace de noms unique pour différencier les contrôles serveur dont la propriété Control..::.ID possède la même valeur. (Hérité de Control.)
	OldValuesParameterFormatString	Obtient ou définit une chaîne de mise en forme à appliquer aux noms de tous les paramètres qui sont passés à la méthode Delete ou Update.
	Page	Obtient une référence à l'instance de Page qui contient le contrôle serveur. (Hérité de Control.)
	Parent	Obtient une référence au contrôle parent du contrôle serveur dans la hiérarchie des contrôles de la page. (Hérité de Control.)
	ProviderName	Obtient ou définit le nom du fournisseur de données .NET Framework que le contrôle SqlDataSource utilise pour se connecter à une source de données sous-jacente.
	RenderingCompatibility	Obtient une valeur qui spécifie la version ASP.NET avec laquelle le HTML restitué sera compatible. (Hérité de Control.)
	SelectCommand	Obtient ou définit la chaîne SQL que le contrôle SqlDataSource utilise pour récupérer des données de la base de données sous-jacente.
	SelectCommandType	Obtient ou définit une valeur indiquant si le texte de la propriété SelectCommand est une requête SQL ou le nom d'une procédure stockée.
	SelectParameters	Obtient la collection de paramètres qui contient les paramètres utilisés par la propriété SelectCommand de l'objet SqlDataSourceView qui est associé au contrôle SqlDataSource.
	Site	Obtient des informations sur le conteneur qui héberge le contrôle en cours lorsqu'il est rendu sur une aire de conception. (Hérité de Control.)
	SkinID	Obtient l'apparence à appliquer au contrôle DataSourceControl. (Hérité de DataSourceControl.)
	SortParameterName	Obtient ou définit le nom d'un paramètre de procédure stockée qui est utilisé pour trier des données récupérées lorsque la récupération de données est exécutée à l'aide d'une procédure stockée.
	SqlCacheDependency	Obtient ou définit une chaîne délimitée par des points-virgules qui indique les bases de données et les tables à utiliser pour la dépendance de cache Microsoft SQL Server.
	TemplateControl	Obtient ou définit une référence au modèle qui contient ce contrôle. (Hérité de Control.)
	TemplateSourceDirectory	Obtient le répertoire virtuel du Page ou du UserControl qui contient le contrôle serveur en cours. (Hérité de Control.)
	UniqueID	Obtient l'identificateur unique qualifié sur le plan hiérarchique du contrôle serveur. (Hérité de Control.)
	UpdateCommand	Obtient ou définit la chaîne SQL que le contrôle SqlDataSource utilise pour mettre à jour des données de la base de données sous-jacente.
	UpdateCommandType	Obtient ou définit une valeur indiquant si le texte de la propriété UpdateCommand est une instruction SQL ou le nom d'une procédure stockée.
	UpdateParameters	Obtient la collection de paramètres qui contient les paramètres utilisés par la propriété UpdateCommand du contrôle SqlDataSourceView qui est associé au contrôle SqlDataSource.
	ViewState	Obtient un dictionnaire d'informations d'état qui vous permet d'enregistrer et de restaurer l'état d'affichage d'un contrôle serveur entre plusieurs demandes de la même page. (Hérité de Control.)
	ViewStateIgnoresCase	Obtient une valeur qui indique si l'objet StateBag respecte la casse. (Hérité de Control.)
	ViewStateMode	Obtient ou définit le mode d'état d'affichage de ce contrôle. (Hérité de Control.)
	Visible	Obtient ou définit une valeur indiquant l'affichage visuel ou non du contrôle. (Hérité de DataSourceControl.)

Début

Méthodes

	Nom	Description
	AddedControl	Appelée après l'ajout d'un contrôle enfant à la collection Controls de l'objet Control. (Hérité de Control.)
	AddParsedSubObject	Avertit le contrôle serveur qu'un élément XML ou HTML a été analysé et l'ajoute à l'objet ControlCollection du contrôle serveur. (Hérité de Control.)
	ApplyStyleSheetSkin	Applique les propriétés de style qui sont définies dans la feuille de style de la page au contrôle. (Hérité de DataSourceControl.)
	BuildProfileTree	Infrastructure. Collecte des informations sur le contrôle serveur et les livre à la propriété Trace à afficher lorsque le traçage est activé pour la page. (Hérité de Control.)
	ClearCachedClientID	Infrastructure. Affecte à la valeur ClientID mise en cache la valeur nullNothingnullptrune référence null (Nothing en Visual Basic). (Hérité de Control.)
	ClearChildControlState	Supprime les informations sur l'état du contrôle des contrôles enfants du contrôle serveur. (Hérité de Control.)
	ClearChildState	Supprime les informations sur l'état d'affichage et sur l'état du contrôle de tous les contrôles enfants du contrôle serveur. (Hérité de Control.)
	ClearChildViewState	Supprime les informations d'état d'affichage de tous les contrôles enfants du contrôle serveur. (Hérité de Control.)
	ClearEffectiveClientIDMode	Infrastructure. Affecte la valeur Inherit à la propriété ClientIDMode de l'instance de contrôle actuelle et de tous contrôles enfants. (Hérité de Control.)
	CreateChildControls	Appelé par l'infrastructure de page ASP.NET pour avertir les contrôles serveur qui utilisent une implémentation basée sur la composition qu'ils doivent créer tous les contrôles enfants qu'ils contiennent en préparation de la publication ou du rendu. (Hérité de Control.)
	CreateControlCollection	Crée une collection pour stocker des contrôles enfants. (Hérité de DataSourceControl.)
	CreateDataSourceView	Crée un objet de vue de source de données associé au contrôle de source de données.
	DataBind()()()	Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants. (Hérité de Control.)
	DataBind(Boolean)	Lie une source de données au contrôle serveur appelé et tous ses contrôles enfants avec une option pour déclencher l'événement DataBinding. (Hérité de Control.)
	DataBindChildren	Lie une source de données aux contrôles enfants du contrôle serveur. (Hérité de Control.)
	Delete	Exécute une opération de suppression à l'aide de la chaîne SQL DeleteCommand et de tous les paramètres de la collection DeleteParameters.
	Dispose	Permet à un contrôle serveur d'effectuer le nettoyage final avant qu'il soit libéré de la mémoire. (Hérité de Control.)
	EnsureChildControls	Détermine si le contrôle serveur contient des contrôles enfants. S'il ne contient pas de contrôles enfants, il en crée. (Hérité de Control.)
	EnsureID	Crée un identificateur pour les contrôles auxquels aucun identificateur n'est assigné. (Hérité de Control.)
	Equals(Object)	Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
	Finalize	Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de netto***ge avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
	FindControl(String)	Recherche un contrôle serveur possédant le paramètre id spécifié dans le conteneur d'attribution de noms actuel. (Hérité de DataSourceControl.)
	FindControl(String, Int32)	Infrastructure. Recherche le conteneur d'attribution de noms actuel d'un contrôle serveur avec l'id spécifié et un entier, spécifié dans le paramètre pathOffset, qui facilite la recherche. Vous ne devez pas substituer cette version de la méthode FindControl. (Hérité de Control.)
	Focus	Définit le focus d'entrée sur le contrôle. (Hérité de DataSourceControl.)
	GetDbProviderFactory	Retourne l'objet DbProviderFactory qui est associé au fournisseur ADO.NET identifié par la propriété ProviderName.
	GetDesignModeState	Infrastructure. Obtient les données au moment du design pour un contrôle. (Hérité de Control.)
	GetHashCode	Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
	GetRouteUrl(Object)	Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control.)
	GetRouteUrl(RouteValueDictionary)	Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control.)
	GetRouteUrl(String, Object)	Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire. (Hérité de Control.)
	GetRouteUrl(String, RouteValueDictionary)	Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire. (Hérité de Control.)
	GetType	Obtient le Type de l'instance actuelle. (Hérité de Object.)
	GetUniqueIDRelativeTo	Retourne la partie préfixée de la propriété UniqueID du contrôle spécifié. (Hérité de Control.)
	GetView	Obtient la vue de source de données associée au contrôle de source de données. (Substitue DataSourceControl..::.GetView(String).)
	GetViewNames	Obtient une collection des noms qui représentent la liste d'objets de vue associée au contrôle SqlDataSource. (Substitue DataSourceControl..::.GetViewNames()()().)
	HasControls	Détermine si le contrôle serveur contient des contrôles enfants. (Hérité de DataSourceControl.)
	HasEvents	Retourne une valeur indiquant si des événements sont inscrits pour le contrôle ou des contrôles enfants. (Hérité de Control.)
	Insert	Exécute une opération d'insertion à l'aide de la chaîne SQL InsertCommand et de tous les paramètres de la collection InsertParameters.
	IsLiteralContent	Infrastructure. Détermine si le contrôle serveur ne détient qu'un contenu littéral. (Hérité de Control.)
	LoadControlState	Restaure des informations sur l'état du contrôle à partir d'une demande de page antérieure enregistrée par la méthode SaveControlState. (Hérité de Control.)
	LoadViewState	Infrastructure. Charge l'état des propriétés du contrôle SqlDataSource qui doivent être persistants. (Substitue Control..::.LoadViewState(Object).)
	MapPathSecure	Récupère le chemin d'accès physique auquel un chemin d'accès virtuel, absolu ou relatif, correspond. (Hérité de Control.)
	MemberwiseClone	Crée une copie superficielle de l'objet Object actif. (Hérité de Object.)
	OnBubbleEvent	Détermine si l'événement pour le contrôle serveur est passé dans la hiérarchie des contrôles serveur de l'interface utilisateur de la page. (Hérité de Control.)
	OnDataBinding	Déclenche l'événement DataBinding. (Hérité de Control.)
	OnInit	Ajoute un gestionnaire d'événements LoadComplete au contrôle Page qui contient le contrôle SqlDataSource. (Substitue Control..::.OnInit(EventArgs).)
	OnLoad	Déclenche l'événement Load. (Hérité de Control.)
	OnPreRender	Déclenche l'événement PreRender. (Hérité de Control.)
	OnUnload	Déclenche l'événement Unload. (Hérité de Control.)
	OpenFile	Obtient un Stream utilisé pour lire un fichier. (Hérité de Control.)
	RaiseBubbleEvent	Assigne les sources éventuelles de l'événement et ses informations au parent du contrôle. (Hérité de Control.)
	RaiseDataSourceChangedEvent	Déclenche l'événement DataSourceChanged. (Hérité de DataSourceControl.)
	RemovedControl	Appelée après la suppression d'un contrôle enfant dans la collection Controls de l'objet Control. (Hérité de Control.)
	Render	Envoie le contenu du contrôle serveur à un objet HtmlTextWriter fourni, qui écrit le contenu à rendre sur le client. (Hérité de Control.)
	RenderChildren	Renvoie le contenu des enfants d'un contrôle serveur dans un objet HtmlTextWriter fourni, qui écrit le contenu à rendre sur le client. (Hérité de Control.)
	RenderControl(HtmlTextWriter)	Renvoie le contenu du contrôle serveur dans un objet HtmlTextWriter fourni et stocke des informations de traçage au sujet du contrôle si le traçage est activé. (Hérité de DataSourceControl.)
	RenderControl(HtmlTextWriter, ControlAdapter)	Génère le contenu du contrôle serveur dans un objet HtmlTextWriter à l'aide d'un objet ControlAdapter fourni. (Hérité de Control.)
	ResolveAdapter	Obtient l'adaptateur de contrôles responsable du rendu du contrôle spécifié. (Hérité de Control.)
	ResolveClientUrl	Obtient une URL qui peut être utilisée par le navigateur. (Hérité de Control.)
	ResolveUrl	Convertit une URL en une URL que le client soit en mesure d'utiliser. (Hérité de Control.)
	SaveControlState	Enregistre les modifications éventuellement apportées à l'état du contrôle serveur depuis la publication de la page sur le serveur. (Hérité de Control.)
	SaveViewState	Infrastructure. Enregistre l'état d'affichage en cours du contrôle SqlDataSource. (Substitue Control..::.SaveViewState()()().)
	Select	Récupère des données de la base de données sous-jacente à l'aide de la chaîne SQL SelectCommand et des paramètres qui se trouvent dans la collection SelectParameters.
	SetDesignModeState	Définit les données au moment du design pour un contrôle. (Hérité de Control.)
	SetRenderMethodDelegate	Infrastructure. Assigne un délégué de gestionnaires d'événements pour générer le rendu du contrôle serveur et de son contenu dans son contrôle parent. (Hérité de Control.)
	ToString	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)
	TrackViewState	Infrastructure. Suit les modifications d'état d'affichage apportées au contrôle SqlDataSource afin que les modifications puissent être stockées dans l'objet System.Web.UI..::.StateBag du contrôle. (Substitue Control..::.TrackViewState()()().)
	Update	Exécute une opération de mise à jour à l'aide de la chaîne SQL UpdateCommand et de tous les paramètres de la collection UpdateParameters.

Début

Événements

	Nom	Description
	DataBinding	Se produit lorsque le contrôle serveur se lie à une source de données. (Hérité de Control.)
	Deleted	Se produit lorsqu'une opération de suppression est terminée.
	Deleting	Se produit avant une opération de suppression.
	Disposed	Se produit lorsqu'un contrôle serveur est libéré de la mémoire, ce qui constitue la dernière étape du cycle de vie d'un contrôle serveur en cas de demande d'une page ASP.NET. (Hérité de Control.)
	Filtering	Se produit avant une opération de filtre.
	Init	Se produit lorsque le contrôle serveur est initialisé, ce qui constitue la première étape de son cycle de vie. (Hérité de Control.)
	Inserted	Se produit lorsqu'une opération d'insertion est terminée.
	Inserting	Se produit avant une opération d'insertion.
	Load	Se produit lorsque le contrôle serveur est chargé dans l'objet Page. (Hérité de Control.)
	PreRender	Se produit après le chargement de l'objet Control mais avant le rendu. (Hérité de Control.)
	Selected	Se produit lorsqu'une opération de récupération de données est terminée.
	Selecting	Se produit avant une opération de récupération de données.
	Unload	Se produit lorsque le contrôle serveur est déchargé de la mémoire. (Hérité de Control.)
	Updated	Se produit lorsqu'une opération de mise à jour est terminée.
	Updating	Se produit avant une opération de mise à jour.

Début

Méthodes d'extension

	Nom	Description
	FindDataSourceControl	Retourne la source de données associée au contrôle de données pour le contrôle spécifié. (Défini par DynamicDataExtensions.)
	FindFieldTemplate	Retourne le modèle de champ pour la colonne spécifiée dans le conteneur d'attribution de noms du contrôle spécifié. (Défini par DynamicDataExtensions.)
	FindMetaTable	Retourne l'objet Metatable pour le contrôle de données conteneur. (Défini par DynamicDataExtensions.)

Début

Implémentations d'interface explicite

Début

Notes

Dans cette rubrique :

Introduction
Connexions de données
Exécution d'opérations de données
Fournisseur de données
Mise en cache
Fonctionnalités supplémentaires
Affichage de la source de données
Syntaxe déclarative

Introduction

Le contrôle de source de données SqlDataSource représente des données dans une base de données relationnelle SQL pour les contrôles liés aux données. Vous pouvez utiliser le contrôle SqlDataSource conjointement à un contrôle lié aux données pour récupérer des données d'une base de données relationnelle et afficher, modifier et trier des données sur une page Web avec peu ou sans code.

Connexions de données

Pour vous connecter à une base de données, vous devez affecter une chaîne de connexion valide à la propriété ConnectionString. SqlDataSource peut prendre en charge n'importe quelle base de données relationnelle SQL à laquelle il est possible de se connecter grâce à un fournisseur ADO.NET, tel que le fournisseur SqlClient, OleDb, Odbc ou OracleClient. Pour plus d'informations sur la sécurisation de chaînes de connexion, consultez Comment : sécuriser des chaînes de connexion lors de l'utilisation de contrôles de source de données.

Pour récupérer des données d'une base de données sous-jacente, définissez la propriété SelectCommand avec une requête SQL. Si la base de données à laquelle SqlDataSource est associé prend en charge les procédures stockées, vous pouvez affecter le nom d'une procédure stockée à la propriété SelectCommand. La requête SQL que vous spécifiez peut également être une requête paramétrée. Vous pouvez ajouter des objets Parameter associés à une requête paramétrée à la collection SelectParameters. Pour plus d'informations sur les requêtes SQL paramétrées et leur syntaxe, consultez Utilisation de paramètres avec des contrôles de source de données.

Le contrôle SqlDataSource récupère des données chaque fois que la méthode Select est appelée. Cette méthode fournit un accès par programme à la méthode spécifiée par la propriété SelectMethod. La méthode Select est appelée automatiquement par des contrôles liés au SqlDataSource lorsque leur méthode DataBind est appelée. Si vous définissez la propriété DataSourceID d'un contrôle lié aux données, le contrôle crée automatiquement une liaison avec les données de la source de données, si nécessaire. La définition de la propriété DataSourceID est la méthode recommandée pour lier un contrôle ObjectDataSource à un contrôle lié aux données. Vous pouvez également utiliser la propriété DataSource, mais vous devrez ensuite appeler explicitement la méthode DataBind du contrôle lié aux données. Parmi les contrôles liés aux données pouvant utiliser SqlDataSource, on trouve DataGrid, DetailsView, DataList et DropDownList. Vous pouvez appeler la méthode Select par programme à tout moment pour récupérer les données de la base de données sous-jacente.

Dans les scénarios ASP.NET déclaratifs et par programme, vous pouvez affecter l'ID du SqlDataSource à la propriété DataSourceID du contrôle lié aux données. Vous pouvez également assigner une instance de la classe SqlDataSource à la propriété DataSource du contrôle lié aux données. Pour plus d'informations sur la liaison de contrôles liés aux données à des contrôles de source de données, consultez Vue d'ensemble de l'accès aux données ASP.NET.

Exécution d'opérations de données

Selon les fonctions du produit de la base de données sous-jacente et la configuration de l'instance de la classe SqlDataSource, vous pouvez exécuter des opérations de données, telles que des mises à jour, des insertions et des suppressions. Pour exécuter ces opérations de données, définissez le texte de commande approprié et tous les paramètres associés pour l'opération que vous souhaitez exécuter. Par exemple, pour une opération de mise à jour, affectez une chaîne SQL ou le nom d'une procédure stockée à la propriété UpdateCommand et ajoutez tous les paramètres requis à la collection UpdateParameters. La mise à jour est effectuée lorsque la méthode Update est appelée, soit explicitement par votre code ou automatiquement par un contrôle lié aux données. Les opérations Delete et Insert suivent le même modèle général.

Les requêtes et commandes SQL que vous utilisez dans les propriétés SelectCommand, UpdateCommand, InsertCommand et DeleteCommand peuvent être paramétrées. Cela signifie que la requête ou commande peut utiliser des espaces réservés au lieu de valeurs littérales et lier les espaces réservés à des variables d'application ou définies par l'utilisateur. Vous pouvez lier des paramètres de requêtes SQL à des variables Session, à des valeurs passées sur la chaîne de requête pour une page Web Forms, aux valeurs de propriété d'autres contrôles serveur, etc. Pour plus d'informations sur l'utilisation de paramètres dans les requêtes SQL avec SqlDataSource, consultez Utilisation de paramètres avec des contrôles de source de données et Utilisation de paramètres avec le contrôle SqlDataSource.

Remarque
Par défaut, si l'un des paramètres est nullNothingnullptrune référence null (Nothing en Visual Basic) lorsque vous exécutez une commande Select, aucune donnée n'est retournée et aucune exception n'est levée. Vous pouvez changer ce comportement en attribuant à la propriété CancelSelectOnNullParameter la valeur false.

Fournisseur de données

Par défaut, le contrôle SqlDataSource utilise le fournisseur de données .NET Framework pour SQL Server, mais SqlDataSource n'est pas spécifique à Microsoft SQL Server. Vous pouvez établir une connexion entre le contrôle SqlDataSource et tout produit de base de données disposant d'un fournisseur ADO.NET managé. Lorsqu'il est utilisé avec le fournisseur System.Data.OleDb, SqlDataSource peut fonctionner avec toute base de données conforme à OLE DB. Lorsqu'il est utilisé avec le fournisseur System.Data.Odbc, SqlDataSource peut être utilisé avec tout pilote et base de données ODBC, y compris IBM DB2, MySQL et PostgreSQL. Lorsqu'il est utilisé avec le fournisseur System.Data.OracleClient, SqlDataSource peut fonctionner avec les bases de données Oracle 8.1.7 et versions ultérieures. La liste des fournisseurs autorisés est enregistrée dans la section DbProviderFactories du fichier de configuration, qui est soit le fichier Machine.config, soit le fichier Web.config. Pour plus d'informations, consultez Sélection de données à l'aide du contrôle SqlDataSource.

Mise en cache

Si vous affichez des données sur votre page à l'aide d'un contrôle SqlDataSource, vous pouvez améliorer la performance de la page en utilisant les fonctionnalités de mise en cache de données du contrôle de source de données. La mise en cache réduit la charge de traitement sur les serveurs de base de données aux dépens de la mémoire sur le serveur Web ; dans la plupart des cas, il s'agit d'un bon compromis. SqlDataSource met les données automatiquement en cache lorsque la propriété EnableCaching a la valeur true et lorsque la valeur de la propriété CacheDuration correspond au nombre de secondes pendant lesquelles le cache stocke les données avant que l'entrée du cache ne soit ignorée. Vous pouvez également spécifier un CacheExpirationPolicy et éventuellement une valeur SqlCacheDependency.

Fonctionnalités supplémentaires

SqlDataSource fournit des fonctions supplémentaires, comme répertorié dans le tableau suivant.

Fonctionnalité	Spécifications
Mise en cache	Affectez la valeur DataSet à la propriété DataSourceMode, la valeur true à la propriété EnableCaching et définissez les propriétés CacheDuration et CacheExpirationPolicy selon le comportement de mise en cache que vous souhaitez pour vos données en mémoire cache.
Suppression	Affectez à la propriété DeleteCommand une instruction SQL utilisée pour supprimer des données. Cette instruction est généralement paramétrée.
Filtrage	Affectez la valeur DataSet à la propriété DataSourceMode. Affectez à la propriété FilterExpression une expression de filtrage utilisée pour filtrer les données lorsque la méthode Select est appelée.
Insertion	Affectez à la propriété InsertCommand une instruction SQL utilisée pour insérer des données. Cette instruction est généralement paramétrée.
Pagination	Non pris en charge actuellement par SqlDataSource. Cependant, certains contrôles liés aux données, tels que GridView, prennent en charge la pagination lorsque vous affectez la valeur DataSet à la propriété DataSourceMode.
Sélection	Affectez à la propriété SelectCommand une instruction SQL utilisée pour récupérer des données.
Tri	Affectez à la propriété DataSourceMode la valeur DataSet.
Mise à jour	Affectez à la propriété UpdateCommand une instruction SQL utilisée pour mettre à jour les données. Cette instruction est généralement paramétrée.

Affichage de la source de données

Comme tous les contrôles de source de données, le contrôle SqlDataSource est associé à une classe d'affichage de la source de données. Le contrôle SqlDataSource n'est associé qu'à un SqlDataSourceView et est toujours nommé Table.

Il n'y a pas de rendu visuel du contrôle SqlDataSource ; il est implémenté comme un contrôle. Vous pouvez donc le créer de manière déclarative et lui permettre éventuellement de participer à la gestion d'état. Par conséquent, SqlDataSource ne prend pas en charge les fonctionnalités visuelles, telles que celles fournies par la propriété EnableTheming ou SkinID.

Syntaxe déclarative

<asp:SqlDataSource
    CacheDuration="string|Infinite"
    CacheExpirationPolicy="Absolute|Sliding"
    CacheKeyDependency="string"
    CancelSelectOnNullParameter="True|False"
    ConflictDetection="OverwriteChanges|CompareAllValues"
    ConnectionString="string"
    DataSourceMode="DataReader|DataSet"
    DeleteCommand="string"
    DeleteCommandType="Text|StoredProcedure"
    EnableCaching="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    FilterExpression="string"
    ID="string"
    InsertCommand="string"
    InsertCommandType="Text|StoredProcedure"
    OldValuesParameterFormatString="string"
    OnDataBinding="DataBinding event handler"
    OnDeleted="Deleted event handler"
    OnDeleting="Deleting event handler"
    OnDisposed="Disposed event handler"
    OnFiltering="Filtering event handler"
    OnInit="Init event handler"
    OnInserted="Inserted event handler"
    OnInserting="Inserting event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnSelected="Selected event handler"
    OnSelecting="Selecting event handler"
    OnUnload="Unload event handler"
    OnUpdated="Updated event handler"
    OnUpdating="Updating event handler"
    ProviderName="string|System.Data.Odbc|System.Data.OleDb|
        System.Data.OracleClient|System.Data.SqlClient|
        Microsoft.SqlServerCe.Client"
    runat="server"
    SelectCommand="string"
    SelectCommandType="Text|StoredProcedure"
    SkinID="string"
    SortParameterName="string"
    SqlCacheDependency="string"
    UpdateCommand="string"
    UpdateCommandType="Text|StoredProcedure"
    Visible="True|False"
>
        <DeleteParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </DeleteParameters>
        <FilterParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </FilterParameters>
        <InsertParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </InsertParameters>
        <SelectParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </SelectParameters>
        <UpdateParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </UpdateParameters>
</asp:SqlDataSource>

Topic	Location
Comment : sécuriser des chaînes de connexion lors de l'utilisation de contrôles de source de données	Génération d'applications Web ASP.NET
Comment : sécuriser des chaînes de connexion lors de l'utilisation de contrôles de source de données	Génération d'applications Web ASP.NET dans Visual Studio
Comment : accéder à SQL Server à l'aide d'un utilisateur de domaine Windows mappé	Génération d'applications Web ASP.NET
Comment : accéder à SQL Server à l'aide d'un utilisateur de domaine Windows mappé	Génération d'applications Web ASP.NET dans Visual Studio
Comment : accéder à SQL Server en tant qu'utilisateur local	Génération d'applications Web ASP.NET
Comment : accéder à SQL Server en tant qu'utilisateur local	Génération d'applications Web ASP.NET dans Visual Studio
Comment : activer le filtrage pour des contrôles SqlDataSource (Visual Studio)	Génération d'applications Web ASP.NET dans Visual Studio
Comment : activer le filtrage pour le contrôle SqlDataSource	Génération d'applications Web ASP.NET
Comment : activer le filtrage pour le contrôle SqlDataSource	Génération d'applications Web ASP.NET dans Visual Studio
Comment : afficher les publicités d'une base de données à l'aide du contrôle serveur Web AdRotator	Génération d'applications Web ASP.NET
Comment : afficher les publicités d'une base de données à l'aide du contrôle serveur Web AdRotator	Génération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles serveur Web Repeater à une page Web Forms	Génération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles serveur Web Repeater à une page Web Forms (Visual Studio)	Génération d'applications Web ASP.NET dans Visual Studio
Comment : établir une connexion à une base de données Access à l'aide du contrôle SqlDataSource	Génération d'applications Web ASP.NET
Comment : établir une connexion à une base de données Access à l'aide du contrôle SqlDataSource (Visual Studio)	Génération d'applications Web ASP.NET dans Visual Studio
Comment : établir une connexion à une base de données Access à l'aide du contrôle SqlDataSource (Visual Studio)	Génération d'applications Web ASP.NET dans Visual Studio
Comment : établir une connexion à une base de données ODBC à l'aide du contrôle SqlDataSource	Génération d'applications Web ASP.NET
Comment : établir une connexion à une base de données ODBC à l'aide du contrôle SqlDataSource (Visual Studio)	Génération d'applications Web ASP.NET dans Visual Studio
Comment : établir une connexion à une base de données ODBC à l'aide du contrôle SqlDataSource (Visual Studio)	Génération d'applications Web ASP.NET dans Visual Studio
Comment : établir une connexion à une base de données Oracle à l'aide du contrôle SqlDataSource (Visual Studio)	Génération d'applications Web ASP.NET dans Visual Studio
Comment : établir une connexion à une base de données Oracle à l'aide du contrôle SqlDataSource (Visual Studio)	Génération d'applications Web ASP.NET dans Visual Studio
Comment : établir une connexion avec une base de données Oracle à l'aide du contrôle SqlDataSource	Génération d'applications Web ASP.NET
Comment : établir une liaison vers les données d'un contrôle basé sur des modèles	Génération d'applications Web ASP.NET
Comment : établir une liaison vers les données d'un contrôle basé sur des modèles	Génération d'applications Web ASP.NET dans Visual Studio
Comment : établir une liaison vers les données d'un contrôle basé sur des modèles dans Visual Studio	Génération d'applications Web ASP.NET dans Visual Studio
Comment : établir une liaison vers les données d'un contrôle basé sur des modèles dans Visual Studio	Génération d'applications Web ASP.NET dans Visual Studio
Comment : permettre aux utilisateurs de supprimer des éléments dans des contrôles serveur Web DataList	Génération d'applications Web ASP.NET
Comment : permettre aux utilisateurs de supprimer des éléments dans des contrôles serveur Web DataList	Génération d'applications Web ASP.NET dans Visual Studio
Comment : personnaliser des contrôles en vue d'une modification dans le contrôle serveur Web GridView	Génération d'applications Web ASP.NET dans Visual Studio
Comment : personnaliser des contrôles en vue d'une modification dans le contrôle serveur Web GridView	Génération d'applications Web ASP.NET dans Visual Studio
Comment : se connecter à une base de données SQL Server à l'aide du contrôle SqlDataSource	Génération d'applications Web ASP.NET
Comment : se connecter à une base de données SQL Server à l'aide du contrôle SqlDataSource (Visual Studio)	Génération d'applications Web ASP.NET dans Visual Studio
Comment : se connecter à une base de données SQL Server à l'aide du contrôle SqlDataSource (Visual Studio)	Génération d'applications Web ASP.NET dans Visual Studio
Comment : sécuriser des chaînes de connexion lors de l'utilisation de contrôles de source de données (Visual Studio)	Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : accès aux données de base dans les pages Web	Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : accès aux données de base dans les pages Web	Génération d'applications à l'aide de Visual Web Developer
Procédure pas à pas : affichage de données à l'aide d'une procédure stockée dans le contrôle serveur Web GridView	Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage de données à l'aide d'une procédure stockée dans le contrôle serveur Web GridView	Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage de données hiérarchiques dans un contrôle TreeView	Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage de données hiérarchiques dans un contrôle TreeView	Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage des données mises en forme dans les pages Web avec le contrôle serveur Web FormView	Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage des données mises en forme dans les pages Web avec le contrôle serveur Web FormView	Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage d'une liste déroulante tout en modifiant le contrôle serveur Web GridView	Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage d'une liste déroulante tout en modifiant le contrôle serveur Web GridView	Génération d'applications à l'aide de Visual Web Developer
Procédure pas à pas : affichage d'une liste déroulante tout en modifiant le contrôle serveur Web GridView	dv_vwdcon
Procédure pas à pas : affichage et mise en forme des données avec le contrôle serveur Web DataList	Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage et mise en forme des données avec le contrôle serveur Web DataList	Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création de pages Web maître/détail dans Visual Studio	Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création de pages Web maître/détail dans Visual Studio	Génération d'applications à l'aide de Visual Web Developer
Procédure pas à pas : modification et insertion de données dans les pages Web avec le contrôle serveur Web DetailsView	Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : modification et insertion de données dans les pages Web avec le contrôle serveur Web DetailsView	Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : tri simple pour le contrôle serveur Web GridView	Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : tri simple pour le contrôle serveur Web GridView	Génération d'applications Web ASP.NET dans Visual Studio

Exemples

Un projet de site Web Visual Studio contenant du code source est disponible pour accompagner cette rubrique : Download.

Cette section comprend quatre exemples de code :

Le premier exemple de code illustre comment afficher des données de SQL Server dans un contrôle GridView à l'aide de la syntaxe déclarative.
Le deuxième exemple de code illustre comment afficher les données d'une base de données ODBC dans un contrôle GridView à l'aide de la syntaxe déclarative.
Le troisième exemple de code illustre comment afficher et mettre à jour des données dans un contrôle GridView.

Le quatrième exemple de code illustre comment afficher et mettre à jour des données dans un contrôle DropDownList.

Remarque
Ces exemples montrent comment utiliser la syntaxe déclarative pour l'accès aux données. Pour plus d'informations sur l'accès aux données à l'aide de code au lieu de balises, consultez Accès aux données dans Visual Studio.

L'exemple de code suivant illustre comment utiliser un contrôle SqlDataSource de manière déclarative pour récupérer des données de SQL Server et les afficher dans un contrôle GridView.

Visual Basic

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html  >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataReader"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html  >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataReader"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>

L'exemple de code suivant illustre comment utiliser un contrôle SqlDataSource de manière déclarative pour récupérer les données d'une base de données ODBC et les afficher dans un contrôle GridView. La propriété ProviderName est le nom du fournisseur de données .NET Framework pour ODBC qui est System.Data.Odbc.

Visual Basic

<%@Page  Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html  >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <!-- This example uses a Northwind database that is hosted by an ODBC-compliant
         database. To run this sample, create an ODBC DSN to any database that hosts
         the Northwind database, including Microsoft SQL Server or Microsoft Access,
         change the name of the DSN in the ConnectionString, and view the page.
    -->
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          ProviderName="System.Data.Odbc"
          DataSourceMode="DataReader"
          ConnectionString="dsn=myodbc3dsn;"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html  >

  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <!-- This example uses a Northwind database that is hosted by an ODBC-compliant
         database. To run this sample, create an ODBC DSN to any database that hosts
         the Northwind database, including Microsoft SQL Server or Microsoft Access,
         change the name of the DSN in the ConnectionString, and view the page.
    -->
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          ProviderName="System.Data.Odbc"
          DataSourceMode="DataReader"
          ConnectionString="dsn=myodbc3dsn;"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>

L'exemple de code suivant montre un affichage commun et met à jour le scénario avec le contrôle GridView. Comme pour les exemples précédents, les données de la base de données Northwind sont affichées dans le contrôle GridView. En outre, étant donné qu'une propriété UpdateCommand est spécifiée et que la propriété AutoGenerateEditButton a la valeur true, vous pouvez modifier et mettre à jour les enregistrements sans code supplémentaire. Le contrôle GridView gère automatiquement les paramètres d'ajout à la collection UpdateParameters et appelle la méthode Update lorsque vous cliquez sur le bouton Mettre à jour dans le contrôle GridView.

Visual Basic

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html  >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataSet"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT EmployeeID,FirstName,LastName,Title FROM Employees"
          UpdateCommand="Update Employees SET FirstName=@FirstName,LastName=@LastName,Title=@Title WHERE EmployeeID=@EmployeeID">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          AutoGenerateColumns="False"
          DataKeyNames="EmployeeID"
          AutoGenerateEditButton="True"
          DataSourceID="SqlDataSource1">
          <columns>
              <asp:BoundField HeaderText="First Name" DataField="FirstName" />
              <asp:BoundField HeaderText="Last Name" DataField="LastName" />
              <asp:BoundField HeaderText="Title" DataField="Title" />
          </columns>

      </asp:GridView>
    </form>
  </body>
</html>

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html  >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataSet"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT EmployeeID,FirstName,LastName,Title FROM Employees"
          UpdateCommand="Update Employees SET FirstName=@FirstName,LastName=@LastName,Title=@Title WHERE EmployeeID=@EmployeeID">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          AutoGenerateColumns="False"
          DataKeyNames="EmployeeID"
          AutoGenerateEditButton="True"
          DataSourceID="SqlDataSource1">
          <columns>
              <asp:BoundField HeaderText="First Name" DataField="FirstName" />
              <asp:BoundField HeaderText="Last Name" DataField="LastName" />
              <asp:BoundField HeaderText="Title" DataField="Title" />
          </columns>

      </asp:GridView>

    </form>
  </body>
</html>

L'exemple de code suivant illustre un scénario d'affichage et de mise à jour commun avec les contrôles DropDownList et TextBox. Le contrôle DropDownList n'ajoute pas automatiquement de paramètres de mise à jour à la collection UpdateParameters et n'appelle pas automatiquement la méthode Update. Vous devez donc le faire. Les paramètres de mise à jour sont spécifiés de manière déclarative et vous pouvez ajouter un gestionnaire d'événements pour exécuter l'opération Update lorsqu'un événement est déclenché.

Note de sécurité
Cet exemple comprend une zone de texte qui accepte une entrée d'utilisateur, ce qui constitue une menace potentielle pour la sécurité. Par défaut, les pages Web ASP.NET vérifient que l'entrée d'utilisateur n'inclut pas de script ni d'éléments HTML. Pour plus d'informations, consultez Vue d'ensemble des attaques de script.

Visual Basic

<%@Page  Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

 Sub On_Click(ByVal source As Object, ByVal e As EventArgs)
    Try
        SqlDataSource1.Update()
    Catch except As Exception
        ' Handle the Exception.
    End Try

    Label2.Text="The record was updated successfully!"

 End Sub 'On_Click
</script>

<html  >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT EmployeeID, LastName, Address FROM Employees"
          UpdateCommand="UPDATE Employees SET Address=@Address WHERE EmployeeID=@EmployeeID">
          <UpdateParameters>
              <asp:ControlParameter Name="Address" ControlId="TextBox1" PropertyName="Text"/>
              <asp:ControlParameter Name="EmployeeID" ControlId="DropDownList1" PropertyName="SelectedValue"/>
          </UpdateParameters>
      </asp:SqlDataSource>

      <asp:DropDownList
          id="DropDownList1"
          runat="server"
          DataTextField="LastName"
          DataValueField="EmployeeID"
          DataSourceID="SqlDataSource1">
      </asp:DropDownList>

      <br />
      <asp:Label id="Label1" runat="server" Text="Enter a new address for the selected user."
        AssociatedControlID="TextBox1" />
      <asp:TextBox id="TextBox1" runat="server" />
      <asp:Button id="Submit" runat="server" Text="Submit" OnClick="On_Click" />

      <br /><asp:Label id="Label2" runat="server" Text="" />
    </form>
  </body>
</html>

<%@Page  Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
 private void On_Click(Object source, EventArgs e) {
    try {
        SqlDataSource1.Update();
    }
    catch (Exception except) {
        // Handle the Exception.
    }

    Label2.Text="The record was updated successfully!";
 }
</script>

<html  >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT EmployeeID, LastName, Address FROM Employees"
          UpdateCommand="UPDATE Employees SET Address=@Address WHERE EmployeeID=@EmployeeID">
          <UpdateParameters>
              <asp:ControlParameter Name="Address" ControlId="TextBox1" PropertyName="Text"/>
              <asp:ControlParameter Name="EmployeeID" ControlId="DropDownList1" PropertyName="SelectedValue"/>
          </UpdateParameters>
      </asp:SqlDataSource>

      <asp:DropDownList
          id="DropDownList1"
          runat="server"
          DataTextField="LastName"
          DataValueField="EmployeeID"
          DataSourceID="SqlDataSource1">
      </asp:DropDownList>

      <br />
      <asp:Label id="Label1" runat="server" Text="Enter a new address for the selected user."
        AssociatedControlID="TextBox1" />
      <asp:TextBox id="TextBox1" runat="server" />
      <asp:Button id="Submit" runat="server" Text="Submit" OnClick="On_Click" />

      <br /><asp:Label id="Label2" runat="server" Text="" />

    </form>
  </body>
</html>

Informations de version

.NET Framework

Pris en charge dans : 4, 3.5, 3.0, 2.0

Plateformes

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Voir aussi