ASP.NET Syntax ASP.NET Syntax for Web Controls
Enables declarative data-binding to objects from a SQL Server™ database.
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>
For information on the individual members of this class, see SqlDataSource in the class library.
The SqlDataSource control represents data in a Microsoft SQL Server™ database to data-bound controls. The SqlDataSource control is used in conjunction with a data-bound control to display the data on a Web Forms page, and optionally allow users to update the data, with little or no code.
The following example demonstrates how to declaratively use a SqlDataSource control to retrieve data from Microsoft SQL Server™ and display it in a GridView control.
<asp:gridview id="CustomersGridView" runat="server"
datasourceid="customers"
width=80% cellpadding=5
font-size = "9pt">
<headerstyle backcolor = "steelblue"
forecolor = "beige" />
<rowstyle verticalalign = "top" />
</asp:gridview>
<asp:sqldatasource id="customers" runat="server"
selectcommand = "SELECT CustomerID, CompanyName, Address, City, PostalCode, Country " +
" FROM Customers"
connectionstring = "<%$ ConnectionStrings:aspnet %>"
datasourcemode = "DataReader" />
Show me
SqlDataSource Class SqlDataSource Web Server Control