SqlDataSource Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Représente une base de données SQL vers des contrôles liés aux données.
public ref class SqlDataSource : System::Web::UI::DataSourceControl[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.SqlDataSource))]
public class SqlDataSource : System.Web.UI.DataSourceControl[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.SqlDataSource))>]
type SqlDataSource = class
inherit DataSourceControlPublic Class SqlDataSource
Inherits DataSourceControl- Héritage
- Dérivé
- Attributs
Exemples
Cette section contient quatre exemples de code :
Le premier exemple de code montre comment afficher des données de SQL Server dans un GridView contrôle à l’aide de la syntaxe déclarative.
Le deuxième exemple de code montre comment afficher des données à partir d’une base de données compatible ODBC dans un contrôle à l’aide d’une GridView syntaxe déclarative.
Le troisième exemple de code montre comment afficher et mettre à jour des données dans un GridView contrôle.
Le quatrième exemple de code montre comment afficher et mettre à jour des données dans un DropDownList contrôle.
Note
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 du code au lieu du balisage, consultez Accès aux données dans Visual Studio.
L’exemple de code suivant montre comment utiliser un SqlDataSource contrôle de manière déclarative pour récupérer des données à partir de SQL Server et l’afficher dans un GridView contrôle.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<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="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<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 montre comment utiliser un SqlDataSource contrôle de manière déclarative pour récupérer des données à partir d’une base de données compatible ODBC et l’afficher dans un GridView contrôle. La ProviderName propriété est le nom du fournisseur de données .NET Framework pour ODBC, qui est System.Data.Odbc.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<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="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<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 illustre un scénario d’affichage et de mise à jour courant avec le GridView contrôle. Comme pour les exemples précédents, les données de la base de données Northwind sont affichées dans le GridView contrôle. En outre, étant donné qu’une UpdateCommand propriété est spécifiée et que la AutoGenerateEditButton propriété est définie truesur , vous pouvez modifier et mettre à jour les enregistrements sans code supplémentaire. Le GridView contrôle gère automatiquement l’ajout de paramètres à la UpdateParameters collection et appelle la Update méthode lorsque le bouton Mettre à jour dans le GridView contrôle est cliqué.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<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="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<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 courant avec les contrôles et TextBox les DropDownList contrôles. Le DropDownList contrôle n’ajoute pas automatiquement de paramètres de mise à jour à la UpdateParameters collection ni appelle la Update méthode. 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 effectuer l’opération Update lorsqu’un événement est déclenché.
Important
Cet exemple inclut une zone de texte qui accepte l’entrée utilisateur, qui est une menace de sécurité potentielle. Par défaut, ASP.NET pages web valident que l’entrée utilisateur n’inclut pas de script ou d’éléments HTML. Pour plus d’informations, consultez Vue d’ensemble des exploits de script.
<%@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 xmlns="http://www.w3.org/1999/xhtml" >
<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="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 xmlns="http://www.w3.org/1999/xhtml" >
<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>
Remarques
Dans cette rubrique :
Présentation
Le SqlDataSource contrôle de source de données représente les données d’une base de données relationnelle SQL aux contrôles liés aux données. Vous pouvez utiliser le SqlDataSource contrôle conjointement avec 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 pas de code.
Data Connections
Pour vous connecter à une base de données, vous devez définir la ConnectionString propriété sur une chaîne de connexion valide. Il SqlDataSource peut prendre en charge n’importe quelle base de données relationnelle SQL qui peut être connectée à l’aide d’un fournisseur ADO.NET, tel que le , ou OleDbOdbcOracleClient le SqlClientfournisseur. Pour plus d’informations sur la sécurisation des chaînes de connexion, consultez Guide pratique pour sécuriser les chaînes de connexion lors de l’utilisation des contrôles de source de données.
Pour récupérer des données à partir d’une base de données sous-jacente, définissez la SelectCommand propriété avec une requête SQL. Si la base de données SqlDataSource associée prend en charge les procédures stockées, vous pouvez définir la SelectCommand propriété sur le nom d’une procédure stockée. La requête SQL que vous spécifiez peut également être une requête paramétrable. Vous pouvez ajouter des Parameter objets associés à une requête paramétrable à la SelectParameters collection. Pour plus d’informations sur les requêtes SQL paramétrables et leur syntaxe, consultez Utilisation de paramètres avec des contrôles de source de données pour le filtrage.
Le SqlDataSource contrôle récupère les données chaque fois que la Select méthode est appelée. Cette méthode fournit un accès programmatique à la méthode spécifiée par SelectMethod propriété. La Select méthode est automatiquement appelée par les contrôles liés au SqlDataSource moment où leur DataBind méthode est appelée. Si vous définissez la DataSourceID propriété d’un contrôle lié aux données, le contrôle est automatiquement lié aux données de la source de données, selon les besoins. La définition de la DataSourceID propriété est la méthode recommandée pour lier un ObjectDataSource contrôle à un contrôle lié aux données. Vous pouvez également utiliser la DataSource propriété, mais vous devez appeler explicitement la DataBind méthode du contrôle lié aux données. Voici quelques exemples de contrôles liés aux données qui peuvent être utilisés SqlDataSource sont DataGrid, DetailsView, DataListet DropDownList. Vous pouvez appeler la Select méthode par programmation à tout moment pour récupérer des données à partir de la base de données sous-jacente.
Dans les scénarios de ASP.NET déclaratifs et programmatiques, vous pouvez définir la DataSourceID propriété du contrôle lié aux données sur l’ID du SqlDataSource contrôle. Vous pouvez également affecter une instance de la SqlDataSource classe à la DataSource propriété du contrôle lié aux données. Pour plus d’informations sur la liaison du contrôle lié aux données aux contrôles de source de données, consultez ASP.NET Options d’accès aux données.
Exécution d’opérations de données
En fonction des fonctionnalités du produit de base de données sous-jacent et de la configuration de l’instance de la SqlDataSource classe, vous pouvez effectuer des opérations de données, telles que des mises à jour, des insertions et des suppressions. Pour effectuer 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 effectuer. Par exemple, pour une opération de mise à jour, définissez la UpdateCommand propriété sur une chaîne SQL ou le nom d’une procédure stockée et ajoutez tous les paramètres requis à la UpdateParameters collection. La mise à jour est effectuée lorsque la Update méthode est appelée, explicitement par votre code ou automatiquement par un contrôle lié aux données. Le même modèle général est suivi pour et pour Delete les Insert opérations.
Les requêtes et commandes SQL que vous utilisez dans les SelectCommandpropriétés et InsertCommandUpdateCommandDeleteCommand les requêtes SQL peuvent être paramétrées. Cela signifie que la requête ou la commande peut utiliser des espaces réservés au lieu de valeurs littérales et lier les espaces réservés aux variables d’application ou définies par l’utilisateur. Vous pouvez lier des paramètres dans les requêtes SQL aux variables de session, les valeurs transmises sur la chaîne de requête d’une page Web Forms, les 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 , SqlDataSourceconsultez Utilisation de paramètres avec des contrôles de source de données pour le filtrage et l’utilisation de paramètres avec le contrôle SqlDataSource.
Note
Par défaut, si l’un des paramètres est null lorsque vous exécutez une Select commande, aucune donnée n’est retournée et aucune exception n’est levée. Vous pouvez modifier ce comportement en définissant la CancelSelectOnNullParameter propriété sur false.
Fournisseur de données
Par défaut, le SqlDataSource contrôle fonctionne avec le fournisseur de données .NET Framework pour SQL Server, mais SqlDataSource n’est pas spécifique à Microsoft SQL Server. Vous pouvez connecter le SqlDataSource contrôle à n’importe quel produit de base de données pour lequel il existe un fournisseur de ADO.NET managé. Lorsqu’il est utilisé avec le System.Data.OleDb fournisseur, il SqlDataSource peut fonctionner avec n’importe quelle base de données conforme à OLE DB. Lorsqu’il est utilisé avec le System.Data.Odbc fournisseur, il SqlDataSource peut être utilisé avec n’importe quel pilote et base de données ODBC, notamment IBM DB2, MySQL et PostgreSQL. Lorsqu’il est utilisé avec le System.Data.OracleClient fournisseur, il SqlDataSource peut utiliser des bases de données Oracle 8.1.7 et versions ultérieures. La liste des fournisseurs autorisés est inscrite dans la DbProviderFactories section du fichier de configuration, dans le fichier Machine.config ou Web.config. Pour plus d’informations, consultez Sélectionner des données à l’aide du contrôle SqlDataSource.
Mise en cache
Si vous affichez des données sur votre page à l’aide d’un SqlDataSource contrôle, vous pouvez augmenter les performances de la page à l’aide des fonctionnalités de mise en cache des 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 au détriment de la mémoire sur le serveur Web ; dans la plupart des cas, c’est un bon compromis. Les SqlDataSource données sont automatiquement mises en cache lorsque la EnableCaching propriété est définie true et la CacheDuration propriété est définie sur le nombre de secondes pendant lesquelles le cache stocke les données avant l’abandon de l’entrée du cache. Vous pouvez également spécifier une valeur facultative et une CacheExpirationPolicy valeur.SqlCacheDependency
Fonctionnalités supplémentaires
Les SqlDataSource fonctionnalités supplémentaires sont disponibles, comme indiqué dans le tableau suivant.
| Capacité | Exigences |
|---|---|
| Mise en cache | Définissez la propriété sur la DataSourceModeDataSet valeur, la EnableCaching propriété truesur et les CacheDurationCacheExpirationPolicy propriétés en fonction du comportement de mise en cache souhaité pour vos données mises en cache. |
| Suppression | Définissez la DeleteCommand propriété sur une instruction SQL utilisée pour supprimer des données. Cette instruction est généralement paramétrée. |
| Filtrage | Définissez la DataSourceMode propriété sur la DataSet valeur. Définissez la FilterExpression propriété sur une expression de filtrage utilisée pour filtrer les données lorsque la Select méthode est appelée. |
| Insertion | Définissez la InsertCommand propriété sur une instruction SQL utilisée pour insérer des données. Cette instruction est généralement paramétrée. |
| Paging | Actuellement non pris en charge par les SqlDataSourcecontrôles liés aux données, tels que , prennent GridViewen charge la pagination lorsque vous définissez la DataSourceMode propriété sur la DataSet valeur. |
| Sélection | Définissez la SelectCommand propriété sur une instruction SQL utilisée pour récupérer des données. |
| Tri | Définissez la propriété DataSourceMode sur DataSet. |
| Mise à jour | Définissez la UpdateCommand propriété sur une instruction SQL utilisée pour mettre à jour les données. Cette instruction est généralement paramétrée. |
Vue de source de données
Comme pour tous les contrôles de source de données, le SqlDataSource contrôle est associé à une classe de vue de source de données. Le SqlDataSource contrôle n’a qu’un seul associé SqlDataSourceView, et il est toujours nommé Table.
Il n’existe aucun rendu visuel du SqlDataSource contrôle ; il est implémenté en tant que contrôle afin de pouvoir le créer de manière déclarative et, éventuellement, pour l’autoriser à participer à la gestion de l’état. Par conséquent, les SqlDataSource fonctionnalités visuelles ne prennent pas en charge les fonctionnalités visuelles, telles que celles fournies par le ou SkinID la EnableTheming propriété.
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>
Constructeurs
| Nom | Description |
|---|---|
| SqlDataSource() |
Initialise une nouvelle instance de la classe SqlDataSource. |
| SqlDataSource(String, String, String) |
Initialise une nouvelle instance de la SqlDataSource classe avec la chaîne de connexion spécifiée et la commande Select. |
| SqlDataSource(String, String) |
Initialise une nouvelle instance de la SqlDataSource classe avec la chaîne de connexion spécifiée et la commande Select. |
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 du ou UserControl de l’objet Page qui contient ce contrôle. (Hérité de Control) |
| BindingContainer |
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, que le contrôle de source de données met en cache les données récupérées par la Select(DataSourceSelectArguments) méthode. |
| CacheExpirationPolicy |
Obtient ou définit le comportement d’expiration du cache qui, lorsqu’il est combiné à la durée, décrit le comportement du cache que le contrôle de source de données utilise. |
| CacheKeyDependency |
Obtient ou définit une dépendance de clé définie par l’utilisateur liée à tous les objets de cache de données créés par le contrôle de source de données. Tous les objets de cache ont expiré explicitement lorsque la clé a expiré. |
| CancelSelectOnNullParameter |
Obtient ou définit une valeur indiquant si une opération de récupération de données est annulée quand un paramètre contenu dans la SelectParameters collection est évalué à |
| ChildControlsCreated |
Obtient une valeur qui indique si les 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 séparateur utilisé dans la ClientID propriété. (Hérité de Control) |
| ConflictDetection |
Obtient ou définit la valeur indiquant comment le SqlDataSource contrôle effectue des mises à jour et supprime lorsque les données d’une ligne dans la base de données sous-jacente changent pendant le temps de l’opération. |
| ConnectionString |
Obtient ou définit la chaîne de connexion ADO.NET spécifique au fournisseur utilisée par le SqlDataSource contrôle pour se connecter à une base de données sous-jacente. |
| Context |
Obtient l’objet HttpContext associé au contrôle serveur pour la requête Web actuelle. (Hérité de Control) |
| Controls |
Obtient un ControlCollection objet 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’affectation de noms si le conteneur d’affectation de IDataItemContainernoms implémente . (Hérité de Control) |
| DataKeysContainer |
Obtient une référence au conteneur d’affectation de noms si le conteneur d’affectation de IDataKeysControlnoms implémente . (Hérité de Control) |
| DataSourceMode |
Obtient ou définit le mode de récupération de données utilisé par le SqlDataSource contrôle pour extraire des données. |
| DeleteCommand |
Obtient ou définit la chaîne SQL utilisée par le SqlDataSource contrôle 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 DeleteCommand propriété 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 DeleteCommand propriété à partir de l’objet SqlDataSourceView associé au SqlDataSource contrôle. |
| DesignMode |
Obtient une valeur indiquant si un contrôle est utilisé sur une surface de conception. (Hérité de Control) |
| EnableCaching |
Obtient ou définit une valeur indiquant si la mise en cache des données est activée pour le SqlDataSource contrôle. |
| EnableTheming |
Obtient une valeur indiquant si ce contrôle prend en charge les thèmes. (Hérité de DataSourceControl) |
| EnableViewState |
Obtient ou définit une valeur indiquant si le contrôle serveur conserve son état d’affichage et l’état d’affichage des contrôles enfants qu’il contient, au client demandeur. (Hérité de Control) |
| Events |
Obtient une liste de délégués de gestionnaire 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 appliquée lorsque la Select(DataSourceSelectArguments) méthode est appelée. |
| FilterParameters |
Obtient une collection de paramètres associés à tous les espaces réservés de paramètres qui se trouvent dans la FilterExpression chaîne. |
| HasChildViewState |
Obtient une valeur indiquant si les contrôles enfants du contrôle serveur actuel ont des paramètres d’état d’affichage enregistrés. (Hérité de Control) |
| ID |
Obtient ou définit l’identificateur programmatique affecté au contrôle serveur. (Hérité de Control) |
| IdSeparator |
Obtient le caractère utilisé pour séparer les identificateurs de contrôle. (Hérité de Control) |
| InsertCommand |
Obtient ou définit la chaîne SQL utilisée par le SqlDataSource contrôle 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 InsertCommand propriété 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 InsertCommand propriété à partir de l’objet SqlDataSourceView associé au SqlDataSource contrôle. |
| IsChildControlStateCleared |
Obtient une valeur indiquant si les contrôles contenus dans ce contrôle ont un état de 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 ID au lieu de l’index. (Hérité de Control) |
| NamingContainer |
Obtient une référence au conteneur d’affectation de noms du contrôle serveur, qui crée un espace de noms unique pour la différenciation entre les contrôles serveur avec la même ID valeur de propriété. (Hérité de Control) |
| OldValuesParameterFormatString |
Obtient ou définit une chaîne de format à appliquer aux noms des paramètres passés à la ou Update() à la Delete() méthode. |
| Page |
Obtient une référence à l’instance 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 page. (Hérité de Control) |
| ProviderName |
Obtient ou définit le nom du fournisseur de données .NET Framework que le SqlDataSource contrôle 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 code HTML rendu est compatible. (Hérité de Control) |
| SelectCommand |
Obtient ou définit la chaîne SQL utilisée par le SqlDataSource contrôle 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 SelectCommand propriété 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 SelectCommand propriété à partir de l’objet SqlDataSourceView associé au SqlDataSource contrôle. |
| Site |
Obtient des informations sur le conteneur qui héberge le contrôle actuel lors du rendu sur une surface de conception. (Hérité de Control) |
| SkinID |
Obtient la peau à appliquer au DataSourceControl contrôle. (Hérité de DataSourceControl) |
| SortParameterName |
Obtient ou définit le nom d’un paramètre de procédure stockée utilisé pour trier les données récupérées lorsque la récupération des données est effectué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 PageUserControl ou qui contient le contrôle serveur actuel. (Hérité de Control) |
| UniqueID |
Obtient l’identificateur unique qualifié hiérarchiquement pour le contrôle serveur. (Hérité de Control) |
| UpdateCommand |
Obtient ou définit la chaîne SQL utilisée par le SqlDataSource contrôle pour mettre à jour les données dans la base de données sous-jacente. |
| UpdateCommandType |
Obtient ou définit une valeur indiquant si le texte de la UpdateCommand propriété 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 UpdateCommand propriété à partir du SqlDataSourceView contrôle associé au SqlDataSource contrôle. |
| ValidateRequestMode |
Obtient ou définit une valeur qui indique si le contrôle vérifie l’entrée du client à partir du navigateur pour obtenir des valeurs potentiellement dangereuses. (Hérité de Control) |
| 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 sur plusieurs requêtes pour la même page. (Hérité de Control) |
| ViewStateIgnoresCase |
Obtient une valeur qui indique si l’objet ne respecte pas la StateBag 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 si le contrôle est affiché visuellement. (Hérité de DataSourceControl) |
Méthodes
| Nom | Description |
|---|---|
| AddedControl(Control, Int32) |
Appelé après l’ajout d’un contrôle enfant à la Controls collection de l’objet Control . (Hérité de Control) |
| AddParsedSubObject(Object) |
Avertit le contrôle serveur qu’un élément, XML ou HTML, a été analysé et ajoute l’élément à l’objet du ControlCollection contrôle serveur. (Hérité de Control) |
| ApplyStyleSheetSkin(Page) |
Applique les propriétés de style définies dans la feuille de style de page au contrôle. (Hérité de DataSourceControl) |
| BeginRenderTracing(TextWriter, Object) |
Commence le suivi au moment du design des données de rendu. (Hérité de Control) |
| BuildProfileTree(String, Boolean) |
Collecte des informations sur le contrôle serveur et le remet à la Trace propriété à afficher lorsque le suivi est activé pour la page. (Hérité de Control) |
| ClearCachedClientID() |
Définit la valeur mise en ClientID cache sur |
| ClearChildControlState() |
Supprime les informations d’état du contrôle pour les contrôles enfants du contrôle serveur. (Hérité de Control) |
| ClearChildState() |
Supprime les informations d’état d’affichage et d’état de contrôle pour 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() |
Définit la ClientIDMode propriété de l’instance de contrôle actuelle et de tous les contrôles enfants sur Inherit. (Hérité de Control) |
| CreateChildControls() |
Appelé par l’infrastructure de page ASP.NET pour notifier les contrôles serveur qui utilisent l’implémentation basée sur la composition pour créer 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 les contrôles enfants. (Hérité de DataSourceControl) |
| CreateDataSourceView(String) |
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() |
Effectue une opération de suppression à l’aide de la DeleteCommand chaîne SQL et de tous les paramètres qui se trouvent dans la DeleteParameters collection. |
| Dispose() |
Permet à un contrôle de serveur d’effectuer le nettoyage final avant de libérer de la mémoire. (Hérité de Control) |
| EndRenderTracing(TextWriter, Object) |
Met fin au suivi au moment du design des données de rendu. (Hérité de Control) |
| EnsureChildControls() |
Détermine si le contrôle serveur contient des contrôles enfants. Si ce n’est pas le cas, il crée des contrôles enfants. (Hérité de Control) |
| EnsureID() |
Crée un identificateur pour les contrôles qui n’ont pas d’identificateur affecté. (Hérité de Control) |
| Equals(Object) |
Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object) |
| FindControl(String, Int32) |
Recherche dans le conteneur d’affectation de noms actuel un contrôle serveur avec l’entier spécifié |
| FindControl(String) |
Recherche le conteneur d’affectation de noms actuel pour un contrôle serveur avec le paramètre spécifié |
| Focus() |
Définit le focus d’entrée sur le contrôle. (Hérité de DataSourceControl) |
| GetDbProviderFactory() |
Retourne l’objet DbProviderFactory associé au fournisseur ADO.NET identifié par la ProviderName propriété. |
| GetDesignModeState() |
Obtient les données au moment du design pour un contrôle. (Hérité de Control) |
| GetHashCode() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetRouteUrl(Object) |
Obtient l’URL qui correspond à un ensemble de paramètres de routage. (Hérité de Control) |
| GetRouteUrl(RouteValueDictionary) |
Obtient l’URL qui correspond à un ensemble de paramètres de routage. (Hérité de Control) |
| GetRouteUrl(String, Object) |
Obtient l’URL qui correspond à un ensemble 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 ensemble de paramètres d’itinéraire et à un nom d’itinéraire. (Hérité de Control) |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| GetUniqueIDRelativeTo(Control) |
Retourne la partie préfixée de la UniqueID propriété du contrôle spécifié. (Hérité de Control) |
| GetView(String) |
Obtient la vue de source de données nommée associée au contrôle de source de données. |
| GetViewNames() |
Obtient une collection de noms représentant la liste des objets d’affichage associés au SqlDataSource contrôle. |
| HasControls() |
Détermine si le contrôle serveur contient des contrôles enfants. (Hérité de DataSourceControl) |
| HasEvents() |
Retourne une valeur indiquant si les événements sont inscrits pour le contrôle ou les contrôles enfants. (Hérité de Control) |
| Insert() |
Effectue une opération d’insertion à l’aide de la InsertCommand chaîne SQL et de tous les paramètres qui se trouvent dans la InsertParameters collection. |
| IsLiteralContent() |
Détermine si le contrôle serveur contient uniquement du contenu littéral. (Hérité de Control) |
| LoadControlState(Object) |
Restaure les informations d’état du contrôle à partir d’une demande de page précédente qui a été enregistrée par la SaveControlState() méthode. (Hérité de Control) |
| LoadViewState(Object) |
Charge l’état des propriétés dans le SqlDataSource contrôle qui doivent être conservées. |
| MapPathSecure(String) |
Récupère le chemin d’accès physique auquel un chemin virtuel, absolu ou relatif, est mappé. (Hérité de Control) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| OnBubbleEvent(Object, EventArgs) |
Détermine si l’événement pour le contrôle serveur est transmis à la hiérarchie de contrôle du serveur d’interface utilisateur de la page. (Hérité de Control) |
| OnDataBinding(EventArgs) |
Déclenche l’événement DataBinding. (Hérité de Control) |
| OnInit(EventArgs) |
Ajoute un gestionnaire d’événements LoadComplete au Page contrôle qui contient le SqlDataSource contrôle. |
| OnLoad(EventArgs) |
Déclenche l’événement Load. (Hérité de Control) |
| OnPreRender(EventArgs) |
Déclenche l’événement PreRender. (Hérité de Control) |
| OnUnload(EventArgs) |
Déclenche l’événement Unload. (Hérité de Control) |
| OpenFile(String) |
Obtient un Stream élément utilisé pour lire un fichier. (Hérité de Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Affecte toutes les sources de l’événement et ses informations au parent du contrôle. (Hérité de Control) |
| RaiseDataSourceChangedEvent(EventArgs) |
Déclenche l’événement DataSourceChanged. (Hérité de DataSourceControl) |
| RemovedControl(Control) |
Appelé après la suppression d’un contrôle enfant de la Controls collection de l’objet Control . (Hérité de Control) |
| Render(HtmlTextWriter) |
Envoie le contenu du contrôle serveur à un objet fourni HtmlTextWriter , qui écrit le contenu à afficher sur le client. (Hérité de Control) |
| RenderChildren(HtmlTextWriter) |
Génère le contenu des enfants d’un contrôle serveur dans un objet fourni HtmlTextWriter , qui écrit le contenu à restituer sur le client. (Hérité de Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Génère le contenu du contrôle serveur sur un objet fourni HtmlTextWriter à l’aide d’un objet fourni ControlAdapter . (Hérité de Control) |
| RenderControl(HtmlTextWriter) |
Génère le contenu du contrôle serveur dans un objet fourni HtmlTextWriter et stocke les informations de suivi sur le contrôle si le suivi est activé. (Hérité de DataSourceControl) |
| ResolveAdapter() |
Obtient l’adaptateur de contrôle responsable du rendu du contrôle spécifié. (Hérité de Control) |
| ResolveClientUrl(String) |
Obtient une URL qui peut être utilisée par le navigateur. (Hérité de Control) |
| ResolveUrl(String) |
Convertit une URL en une URL utilisable sur le client demandeur. (Hérité de Control) |
| SaveControlState() |
Enregistre les modifications d’état de contrôle du serveur qui se sont produites depuis la publication de la page sur le serveur. (Hérité de Control) |
| SaveViewState() |
Enregistre l’état d’affichage actuel du SqlDataSource contrôle. |
| Select(DataSourceSelectArguments) |
Récupère les données de la base de données sous-jacente à l’aide de la SelectCommand chaîne SQL et de tous les paramètres qui se trouvent dans la SelectParameters collection. |
| SetDesignModeState(IDictionary) |
Définit les données au moment du design pour un contrôle. (Hérité de Control) |
| SetRenderMethodDelegate(RenderMethod) |
Affecte un délégué de gestionnaire d’événements pour restituer le contrôle serveur et son contenu dans son contrôle parent. (Hérité de Control) |
| SetTraceData(Object, Object, Object) |
Définit les données de trace pour le suivi au moment du design des données de rendu, à l’aide de l’objet suivi, de la clé de données de trace et de la valeur des données de trace. (Hérité de Control) |
| SetTraceData(Object, Object) |
Définit les données de trace pour le suivi au moment du design des données de rendu, à l’aide de la clé de données de trace et de la valeur des données de trace. (Hérité de Control) |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |
| TrackViewState() |
Effectue le suivi des modifications de l’état d’affichage du SqlDataSource contrôle afin que les modifications puissent être stockées dans l’objet StateBag du contrôle. |
| Update() |
Effectue une opération de mise à jour à l’aide de la UpdateCommand chaîne SQL et de tous les paramètres qui se trouvent dans la UpdateParameters collection. |
É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, qui est la dernière étape du cycle de vie du contrôle de serveur lorsqu’une page ASP.NET est demandée. (Hérité de Control) |
| Filtering |
Se produit avant une opération de filtre. |
| Init |
Se produit lorsque le contrôle serveur est initialisé, qui est 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. |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| IControlBuilderAccessor.ControlBuilder |
Pour obtenir une description de ce membre, consultez ControlBuilder. (Hérité de Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Pour obtenir une description de ce membre, consultez GetDesignModeState(). (Hérité de Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Pour obtenir une description de ce membre, consultez SetDesignModeState(IDictionary). (Hérité de Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Pour obtenir une description de ce membre, consultez SetOwnerControl(Control). (Hérité de Control) |
| IControlDesignerAccessor.UserData |
Pour obtenir une description de ce membre, consultez UserData. (Hérité de Control) |
| IDataBindingsAccessor.DataBindings |
Pour obtenir une description de ce membre, consultez DataBindings. (Hérité de Control) |
| IDataBindingsAccessor.HasDataBindings |
Pour obtenir une description de ce membre, consultez HasDataBindings. (Hérité de Control) |
| IDataSource.DataSourceChanged |
Se produit lorsqu’un contrôle de source de données a changé d’une manière qui affecte les contrôles liés aux données. (Hérité de DataSourceControl) |
| IDataSource.GetView(String) |
Obtient l’objet nommé DataSourceView associé au DataSourceControl contrôle. Certains contrôles de source de données ne prennent en charge qu’une seule vue, tandis que d’autres prennent en charge plusieurs. (Hérité de DataSourceControl) |
| IDataSource.GetViewNames() |
Obtient une collection de noms, représentant la liste des DataSourceView objets associés au DataSourceControl contrôle. (Hérité de DataSourceControl) |
| IExpressionsAccessor.Expressions |
Pour obtenir une description de ce membre, consultez Expressions. (Hérité de Control) |
| IExpressionsAccessor.HasExpressions |
Pour obtenir une description de ce membre, consultez HasExpressions. (Hérité de Control) |
| IListSource.ContainsListCollection |
Indique si le contrôle de source de données est associé à une ou plusieurs listes de données. (Hérité de DataSourceControl) |
| IListSource.GetList() |
Obtient une liste de contrôles de source de données qui peuvent être utilisés comme sources de listes de données. (Hérité de DataSourceControl) |
| IParserAccessor.AddParsedSubObject(Object) |
Pour obtenir une description de ce membre, consultez AddParsedSubObject(Object). (Hérité de Control) |
Méthodes d’extension
| Nom | Description |
|---|---|
| FindDataSourceControl(Control) |
Retourne la source de données associée au contrôle de données pour le contrôle spécifié. |
| FindFieldTemplate(Control, String) |
Retourne le modèle de champ de la colonne spécifiée dans le conteneur d’affectation de noms du contrôle spécifié. |
| FindMetaTable(Control) |
Retourne l’objet métatable pour le contrôle de données contenant. |
| GetDefaultValues(IDataSource) |
Obtient la collection des valeurs par défaut pour la source de données spécifiée. |
| GetMetaTable(IDataSource) |
Obtient les métadonnées d’une table dans l’objet de source de données spécifié. |
| TryGetMetaTable(IDataSource, MetaTable) |
Détermine si les métadonnées de table sont disponibles. |
