SqlDataSource Classe

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

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 DataSourceControl

Public Class SqlDataSource
Inherits DataSourceControl

Héritage: Object

Control

DataSourceControl
SqlDataSource

Dérivé: System.Web.UI.WebControls.AccessDataSource

Attributs: ToolboxBitmapAttribute

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 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 façon 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 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 AutoGenerateEditButtontruevaleur , 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 l’utilisateur clique 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 et n’appelle pas 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 potentielle pour la sécurité. Par défaut, les pages web ASP.NET vérifient que l’entrée d’utilisateur n’inclut pas de script 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
Connexions de données
Exécution d’opérations de données
Fournisseur de données
Mise en cache
Fonctionnalités supplémentaires
Vue de source de données
Syntaxe déclarative

Introduction

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 à 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 propriété sur ConnectionString 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 fournisseur. 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 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 programmatique à la méthode spécifiée par SelectMethod la propriété . La Select méthode est automatiquement appelée par les 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 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 utiliser SqlDataSource , DetailsView DataGrid, 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 une 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 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, 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 à des variables d’application ou 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 pour une page 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 , consultez Utilisation de paramètres avec des contrôles de source de données pour le SqlDataSourcefiltrage et Utilisation de paramètres avec le contrôle SqlDataSource.

Notes

Par défaut, si l’un des paramètres est null lorsque vous exécutez une Select commande, aucune donnée ne sera retournée et aucune exception ne sera levée. Vous pouvez modifier ce comportement en affectant à la propriété la CancelSelectOnNullParameter valeur 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, peut SqlDataSource fonctionner avec n’importe quelle base de données compatible OLE DB. Lorsqu’il est utilisé avec le System.Data.Odbc fournisseur, peut SqlDataSource ê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, 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 à 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, il s’agit d’un bon compromis. Met SqlDataSource 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é sur `true`, et les CacheDuration propriétés et CacheExpirationPolicy en fonction du comportement de mise en cache que vous souhaitez 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étrable.
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étrable.
Pagination	Non pris en charge actuellement 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étrable.

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 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 à `null`.
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 `null`. (Hérité de Control)
ClearChildControlState()	Supprime les informations sur l'état du contrôle des contrôles enfants du contrôle serveur. (Hérité de Control)
ClearChildState()	Supprime les informations sur l'état d'affichage et sur l'état du contrôle de tous les contrôles enfants du contrôle serveur. (Hérité de Control)
ClearChildViewState()	Supprime les informations d'état d'affichage de tous les contrôles enfants du contrôle serveur. (Hérité de Control)
ClearEffectiveClientIDMode()	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 `id` spécifié dans le conteneur d'attribution de noms actuel. (Hérité de DataSourceControl)
FindControl(String, Int32)	Recherche le conteneur d'attribution de noms actuel d'un contrôle serveur avec l'`id` spécifié et un entier, spécifié dans le paramètre `pathOffset`, qui facilite la recherche. Vous ne devez pas substituer cette version de la méthode FindControl. (Hérité de Control)
Focus()	Définit le focus d'entrée sur le contrôle. (Hérité de DataSourceControl)
GetDbProviderFactory()	Retourne l'objet DbProviderFactory qui est associé au fournisseur ADO.NET identifié par la propriété ProviderName.
GetDesignModeState()	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 à

Partager via