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 pour les 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 les 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 d’une base de données compatible ODBC dans un GridView contrôle à l’aide de la 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.
Notes
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 les 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 les 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 dans 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 propriété a la AutoGenerateEditButton valeur true, 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 vous cliquez sur le bouton Mettre à jour dans le 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="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 DropDownList contrôles et TextBox . Le DropDownList contrôle n’ajoute pas automatiquement de paramètres de mise à jour à la UpdateParameters collection ni n’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, les pages web ASP.NET vérifient que l’entrée d’utilisateur n’inclut pas de script ou d’éléments HTML. Pour plus d’informations, consultez Vue d’ensemble des attaques 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 :
Introduction
Le SqlDataSource contrôle de source de données représente les données d’une base de données relationnelle SQL en 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 à partir d’une base de données relationnelle et pour afficher, modifier et trier des données sur une page web avec peu ou pas de code.
Connexions de données
Pour vous connecter à une base de données, vous devez définir la ConnectionString propriété sur une chaîne de connexion valide. peut SqlDataSource prendre en charge n’importe quelle base de données relationnelle SQL qui peut être connectée à l’aide d’un fournisseur de ADO.NET, tel que , SqlClientOleDb, Odbcou OracleClient . 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 de 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 à laquelle SqlDataSource est associé 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 Parameter des 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 des données chaque fois que la Select méthode est appelée. Cette méthode fournit un accès par programmation à la méthode spécifiée par SelectMethod la propriété . La Select méthode est appelée automatiquement par des contrôles qui sont liés au SqlDataSource lorsque 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 se lie automatiquement 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. 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 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 un instance de la SqlDataSource classe à la DataSource propriété du contrôle lié aux données. Pour plus d’informations sur la liaison d’un contrôle lié aux données à des 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 du 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, soit explicitement par votre code, soit automatiquement par un contrôle lié aux données. Le même modèle général est suivi pour Delete les opérations et Insert .
Les requêtes et commandes SQL que vous utilisez dans les SelectCommandpropriétés , UpdateCommand, InsertCommandet DeleteCommand 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 à l’application ou à des variables définies par l’utilisateur. Vous pouvez lier des paramètres dans des requêtes SQL à des variables de session, des valeurs transmises sur la chaîne de requête d’une page de Web Forms, les valeurs de propriété d’autres contrôles serveur, etc. Pour plus d’informations sur l’utilisation des 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 Utilisation de paramètres avec le contrôle SqlDataSource.
Notes
Par défaut, si l’un des paramètres est lorsque vous exécutez une Select commande, aucune donnée n’est retournée et aucune exception n’est null 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, le SqlDataSource peut fonctionner avec n’importe quelle base de données compatible OLE DB. Lorsqu’il est utilisé avec le System.Data.Odbc fournisseur, SqlDataSource le peut être utilisé avec n’importe quel pilote et base de données ODBC, y compris IBM DB2, MySQL et PostgreSQL. Lorsqu’il est utilisé avec le System.Data.OracleClient fournisseur, le peut fonctionner avec les SqlDataSource 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, soit dans le fichier Machine.config, soit dans 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 SqlDataSource contrôle, vous pouvez augmenter les performances de la page en utilisant les 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, il s’agit d’un bon compromis. Le SqlDataSource met automatiquement en cache les données lorsque la EnableCaching propriété est définie sur true et que la CacheDuration propriété est définie sur le 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 une CacheExpirationPolicy valeur et une valeur facultative SqlCacheDependency .
Fonctionnalités supplémentaires
fournit SqlDataSource des fonctionnalités supplémentaires, comme indiqué dans le tableau suivant.
| Fonctionnalité | Spécifications |
|---|---|
| Mise en cache | Définissez la DataSourceMode propriété sur la DataSet valeur, la EnableCaching propriété truesur et les CacheDuration propriétés et CacheExpirationPolicy en fonction du comportement de mise en cache souhaité pour vos données mises en cache. |
| Suppression | Définissez la propriété sur DeleteCommand une instruction SQL utilisée pour supprimer des données. Cette instruction est généralement paramétrée. |
| Filtrage | Définir le DataSourceMode propriété le 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 propriété sur InsertCommand une instruction SQL utilisée pour insérer des données. Cette instruction est généralement paramétrée. |
| Pagination | Actuellement non pris en charge par le SqlDataSource, mais certains contrôles liés aux données, tels que GridView, prennent en charge la pagination lorsque vous définissez la DataSourceMode propriété sur la DataSet valeur. |
| Sélectionnez | Définissez la propriété sur SelectCommand une instruction SQL utilisée pour récupérer des données. |
| Tri | Affectez à la propriété DataSourceMode la valeur DataSet. |
| Mise à jour | Définissez la propriété sur UpdateCommand 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 d’affichage 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 que vous puissiez le créer de manière déclarative et, éventuellement, pour lui permettre de participer à la gestion de l’état. Par conséquent, le ne prend pas en charge les SqlDataSource fonctionnalités visuelles, telles que celles fournies par la EnableTheming propriété 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>
Constructeurs
| 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. |
Propriétés
| 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 |
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(DataSourceSelectArguments). |
| 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 à |
| 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 propre au fournisseur ADO.NET utilisée par le contrôle SqlDataSource 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 pour 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 conserve son état d’affichage, et l’état d’affichage de tous les contrôles enfants qu’il contient, au client demandeur. (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 appliquée lorsque la méthode Select(DataSourceSelectArguments) 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 |
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é 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. |
| ValidateRequestMode |
Obtient ou définit une valeur qui indique si le contrôle vérifie l'entrée cliente du navigateur à la recherche de 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 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) |
Méthodes
| AddedControl(Control, Int32) |
Méthode appelée après qu’un contrôle enfant est ajouté à la collection Controls 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 ControlCollection du contrôle serveur. (Hérité de Control) |
| ApplyStyleSheetSkin(Page) |
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) |
| BeginRenderTracing(TextWriter, Object) |
Commence le traçage 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 les livre à la propriété Trace à afficher lorsque le traçage est activé pour la page. (Hérité de Control) |
| ClearCachedClientID() |
Affecte à la valeur ClientID mise en cache la valeur |
| 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() |
Affecte la valeur ClientIDMode à la propriété Inherit de l'instance de contrôle actuelle et de tous contrôles enfants. (Hérité de Control) |
| CreateChildControls() |
Appelée par l’infrastructure de page ASP.NET pour signaler aux contrôles serveur qu’ils doivent utiliser l’implémentation basée sur la composition pour créer les contrôles enfants qu’ils contiennent en vue 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(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() |
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) |
| EndRenderTracing(TextWriter, Object) |
Met fin au traçage 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. 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'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
| FindControl(String) |
Recherche un contrôle serveur possédant le paramètre |
| FindControl(String, Int32) |
Recherche le conteneur d'attribution de noms actuel d'un contrôle serveur avec l' |
| 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() |
Obtient les données au moment du design pour un contrôle. (Hérité de Control) |
| GetHashCode() |
Fait office de fonction de hachage par défaut. (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(Control) |
Retourne la partie préfixée de la propriété UniqueID du contrôle spécifié. (Hérité de Control) |
| GetView(String) |
Obtient la vue de source de données associée au contrôle de source de données. |
| GetViewNames() |
Obtient une collection des noms qui représentent la liste d'objets de vue associée au contrôle SqlDataSource. |
| 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() |
Détermine si le contrôle serveur ne détient qu'un contenu littéral. (Hérité de Control) |
| LoadControlState(Object) |
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(Object) |
Charge l'état des propriétés du contrôle SqlDataSource qui doivent être persistants. |
| MapPathSecure(String) |
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 du Object actuel. (Hérité de Object) |
| OnBubbleEvent(Object, EventArgs) |
Détermine si l’événement du 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(EventArgs) |
Déclenche l’événement DataBinding. (Hérité de Control) |
| OnInit(EventArgs) |
Ajoute un gestionnaire d'événements LoadComplete au contrôle Page qui contient le contrôle SqlDataSource. |
| 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 utilisé pour lire un fichier. (Hérité de Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Assigne les sources éventuelles 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) |
Méthode appelée après la suppression d’un contrôle enfant de la collection Controls de l’objet Control. (Hérité de Control) |
| Render(HtmlTextWriter) |
Envoie le contenu du contrôle serveur à un objet HtmlTextWriter, qui écrit le contenu à rendre sur le client. (Hérité de Control) |
| RenderChildren(HtmlTextWriter) |
Produit le contenu des enfants d'un contrôle serveur dans un objet HtmlTextWriter fourni qui écrit le contenu à restituer sur le client. (Hérité de Control) |
| RenderControl(HtmlTextWriter) |
Envoie le contenu du contrôle serveur à un objet HtmlTextWriter fourni et stocke les informations de traçage sur le 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(String) |
Obtient une URL qui peut être utilisée par le navigateur. (Hérité de Control) |
| ResolveUrl(String) |
Convertit une URL en une URL que le client soit en mesure d'utiliser. (Hérité de Control) |
| SaveControlState() |
Enregistre tous les changements d’état de contrôle serveur qui ont eu lieu depuis que la page a été publiée sur le serveur. (Hérité de Control) |
| SaveViewState() |
Enregistre l'état d'affichage actuel du contrôle SqlDataSource. |
| Select(DataSourceSelectArguments) |
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(IDictionary) |
Définit les données au moment du design pour un contrôle. (Hérité de Control) |
| SetRenderMethodDelegate(RenderMethod) |
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) |
| SetTraceData(Object, Object) |
Définit les données de trace pour le suivi du rendu des données au moment du design à l'aide de la clé des données de trace et de la valeur des données de trace. (Hérité de Control) |
| SetTraceData(Object, Object, Object) |
Définit les données de trace pour le suivi du rendu des données au moment du design, à l'aide de l'objet suivi, de la clé des 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() |
Suit les modifications d'état d'affichage apportées au contrôle SqlDataSource afin que les modifications puissent être stockées dans l'objet StateBag du contrôle. |
| 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. |
Événements
| 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. |
Implémentations d’interfaces explicites
| 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 code source de données a changé d'une manière qui affecte des contrôles liés aux données. (Hérité de DataSourceControl) |
| IDataSource.GetView(String) |
Obtient l'objet nommé DataSourceView associé au contrôle DataSourceControl. Certains contrôles de code source de données ne prennent en charge qu'un affichage, contrairement à d'autres qui en gèrent plusieurs. (Hérité de DataSourceControl) |
| IDataSource.GetViewNames() |
Obtient une collection de noms, représentant la liste des objets DataSourceView associés au contrôle DataSourceControl. (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 code source de données est associé à une ou à plusieurs listes de données. (Hérité de DataSourceControl) |
| IListSource.GetList() |
Obtient une liste des contrôles de code source de données qui peuvent être utilisés comme sources des 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
| 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 pour la colonne spécifiée dans le conteneur d'attribution de noms du contrôle spécifié. |
| FindMetaTable(Control) |
Retourne l'objet Metatable pour le contrôle de données conteneur. |
| 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 pour une table dans l'objet source de données spécifié. |
| TryGetMetaTable(IDataSource, MetaTable) |
Détermine si des métadonnées de table sont disponibles. |
S’applique à
Voir aussi
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour