Partage via

SqlDataSource Constructeurs

  • Référence

Définition

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

Initialise une nouvelle instance de la classe SqlDataSource.

Surcharges

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.

SqlDataSource()

Initialise une nouvelle instance de la classe SqlDataSource.

public:
 SqlDataSource();
public SqlDataSource ();
Public Sub New ()

Voir aussi

S’applique à

SqlDataSource(String, String)

Initialise une nouvelle instance de la classe SqlDataSource avec la chaîne de connexion spécifiée et la commande Select.

public:
 SqlDataSource(System::String ^ connectionString, System::String ^ selectCommand);
public SqlDataSource (string connectionString, string selectCommand);
new System.Web.UI.WebControls.SqlDataSource : string * string -> System.Web.UI.WebControls.SqlDataSource
Public Sub New (connectionString As String, selectCommand As String)

Paramètres

connectionString
String

Chaîne de connexion utilisée pour connecter la base de données sous-jacente.

selectCommand
String

Requête SQL utilisée pour récupérer les données de la base de données sous-jacente. Si la requête SQL est une chaîne SQL paramétrée, vous devrez probablement ajouter des objets Parameter à la collection SelectParameters.

Exemples

L’exemple de code suivant montre comment créer un SqlDataSource contrôle à l’aide du SqlDataSource constructeur . L’exemple est inhabituel dans la mesure où le SqlDataSource contrôle est utilisé non pas sur une page Web Forms, mais dans l’implémentation d’un objet de niveau intermédiaire comme moyen simple pour un objet métier d’interagir avec une base de données. L’exemple utilise une chaîne de connexion stockée dans le fichier Web.config.

Cet exemple de code fait partie d’un exemple plus grand fourni pour la ObjectDataSource classe .

// Returns a collection of NorthwindEmployee objects.
public static ICollection GetAllEmployees () {
  ArrayList al = new ArrayList();

  ConnectionStringSettings cts = ConfigurationManager.ConnectionStrings["NorthwindConnection"];

  SqlDataSource sds
    = new SqlDataSource(cts.ConnectionString, "SELECT EmployeeID FROM Employees");

  try {

    IEnumerable IDs = sds.Select(DataSourceSelectArguments.Empty);

    // Iterate through the Enumeration and create a
    // NorthwindEmployee object for each ID.
    foreach (DataRowView row in IDs) {
      string id = row["EmployeeID"].ToString();
      NorthwindEmployee nwe = new NorthwindEmployee(id);
      // Add the NorthwindEmployee object to the collection.
      al.Add(nwe);
    }
  }
  finally {
    // If anything strange happens, clean up.
    sds.Dispose();
  }

  return al;
}

' Returns a collection of NorthwindEmployee objects.
Public Shared Function GetAllEmployees() As ICollection
   Dim al As New ArrayList()

   Dim cts As ConnectionStringSettings = ConfigurationManager.ConnectionStrings("NorthwindConnection")
   Dim sds As New SqlDataSource(cts.ConnectionString, "SELECT EmployeeID FROM Employees")
   Try
      Dim IDs As IEnumerable = sds.Select(DataSourceSelectArguments.Empty)

      ' Iterate through the Enumeration and create a
      ' NorthwindEmployee object for each ID.
      For Each row As DataRowView In IDs
         Dim id As String = row("EmployeeID").ToString()
         Dim nwe As New NorthwindEmployee(id)
         ' Add the NorthwindEmployee object to the collection.
         al.Add(nwe)
      Next
   Finally
      ' If anything strange happens, clean up.
      sds.Dispose()
   End Try

   Return al
End Function 'GetAllEmployees

Remarques

Étant donné que les produits de base de données différents utilisent des variétés différentes de SQL, la syntaxe de selectCommand dépend du fournisseur ADO.NET utilisé, qui est identifié par le ProviderName propriété. Si la chaîne SQL est une requête ou une commande paramétrée, l'espace réservé du paramètre dépend également du fournisseur ADO.NET utilisé. Par exemple, si le fournisseur est , System.Data.SqlClientqui est le fournisseur par défaut pour la SqlDataSource classe , l’espace réservé du paramètre est '@parameterName'. Toutefois, si le fournisseur est défini sur System.Data.Odbc ou , System.Data.OleDbl’espace réservé du paramètre est '?'. Pour plus d’informations sur les requêtes et commandes SQL paramétrables, consultez Utilisation de paramètres avec le contrôle SqlDataSource.

La SelectCommand valeur peut être une chaîne SQL ou le nom d’une procédure stockée, si la source de données prend en charge les procédures stockées.

Voir aussi

S’applique à

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.

public:
 SqlDataSource(System::String ^ providerName, System::String ^ connectionString, System::String ^ selectCommand);
public SqlDataSource (string providerName, string connectionString, string selectCommand);
new System.Web.UI.WebControls.SqlDataSource : string * string * string -> System.Web.UI.WebControls.SqlDataSource
Public Sub New (providerName As String, connectionString As String, selectCommand As String)

Paramètres

providerName
String

Nom du fournisseur de données utilisé par SqlDataSource. Si aucun fournisseur n'est défini, SqlDataSource utilise par défaut le fournisseur ADO.NET pour Microsoft SQL Server.

connectionString
String

Chaîne de connexion utilisée pour connecter la base de données sous-jacente.

selectCommand
String

Requête SQL utilisée pour récupérer les données de la base de données sous-jacente. Si la requête SQL est une chaîne SQL paramétrée, vous devrez probablement ajouter des objets Parameter à la collection SelectParameters.

Remarques

Étant donné que les produits de base de données différents utilisent des variétés différentes de SQL, la syntaxe de selectCommand dépend du fournisseur ADO.NET utilisé, qui est identifié par le providerName paramètre. Si la chaîne SQL est une requête ou une commande paramétrée, l'espace réservé du paramètre dépend également du fournisseur ADO.NET utilisé. Par exemple, si le fournisseur est System.Data.SqlClient, qui est le fournisseur par défaut pour la SqlDataSource classe , l’espace réservé du paramètre est '@parameterName'. Toutefois, si le fournisseur est défini sur System.Data.Odbc ou , System.Data.OleDbl’espace réservé du paramètre est '?'. Pour plus d’informations sur les requêtes et commandes SQL paramétrables, consultez Utilisation de paramètres avec le contrôle SqlDataSource.

La SelectCommand propriété peut être une chaîne SQL ou le nom d’une procédure stockée, si la source de données prend en charge les procédures stockées.

Voir aussi

S’applique à