Partager via

SqlDataSource.ConnectionString Propriété

  • Référence

Définition

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

Obtient ou définit la chaîne de connexion spécifique au fournisseur ADO.NET utilisée par le contrôle SqlDataSource pour se connecter à une base de données sous-jacente.

public:
 virtual property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };
public virtual string ConnectionString { get; set; }
member this.ConnectionString : string with get, set
Public Overridable Property ConnectionString As String

Valeur de propriété

String

Chaîne spécifique au fournisseur de données .NET Framework utilisée par l'SqlDataSource pour se connecter à la base de données SQL qu’elle représente. La valeur par défaut est une chaîne vide ( » « ).

Exemples

L’exemple de code suivant montre comment définir la propriété ConnectionString pour se connecter à une base de données SQL Server et afficher les résultats de la propriété SelectCommand dans un contrôle GridView.

<%@ 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>

Remarques

Le contrôle SqlDataSource peut être utilisé avec diverses ADO.NET fournisseurs et la syntaxe de la chaîne de connexion utilisée pour se connecter à une source de données sous-jacente est spécifique au fournisseur.

Lorsque vous configurez un contrôle SqlDataSource, vous définissez la propriété ProviderName sur le type de base de données (la valeur par défaut est System.Data.SqlClient) et vous définissez la propriété ConnectionString sur une chaîne de connexion qui inclut des informations requises pour vous connecter à la base de données. Le contenu d’une chaîne de connexion diffère selon le type de base de données auquel le contrôle de source de données accède. Par exemple, le contrôle SqlDataSource nécessite un nom de serveur, un nom de base de données (catalogue) et des informations sur l’authentification de l’utilisateur lors de la connexion à un serveur SQL Server. Pour plus d’informations sur le contenu des chaînes de connexion, consultez la propriété ConnectionString pour la classe SqlConnection, la propriété ConnectionString pour la classe OracleConnection, la propriété ConnectionString pour la classe OleDbConnection ou la propriété ConnectionString pour la classe OdbcConnection.

Si vous modifiez la propriété ConnectionString, l’événement DataSourceChanged est déclenché, ce qui entraîne la liaison de tous les contrôles liés au contrôle SqlDataSource à rebiner.

Important

Pour plus d’informations sur le stockage d’une chaîne 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.

S’applique à

Voir aussi