Partager via

SqlDataSource Constructeurs

Définition

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

Initialise une nouvelle instance de la classe SqlDataSource.

Surcharges

Nom Description
SqlDataSource()

Initialise une nouvelle instance de la classe SqlDataSource.
SqlDataSource(String, String)

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

Initialise une nouvelle instance de la SqlDataSource classe 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 SqlDataSource classe 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 se connecter à la base de données sous-jacente.

selectCommand
String

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

Exemples

L’exemple de code suivant montre comment créer un SqlDataSource contrôle à l’aide du SqlDataSource constructeur. L’exemple est inhabituel dans le fait que le SqlDataSource contrôle n’est pas utilisé 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 différents produits de base de données utilisent différentes variétés de SQL, la syntaxe pour selectCommand dépend du fournisseur de ADO.NET actuel utilisé, qui est identifié par la ProviderName propriété. Si la chaîne SQL est une requête ou une commande paramétrable, l’espace réservé du paramètre dépend également du fournisseur ADO.NET utilisé. Par exemple, si le fournisseur est le System.Data.SqlClientfournisseur , 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 le System.Data.Odbc ou l’espace System.Data.OleDbré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 SqlDataSource classe 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 que l’utilise SqlDataSource . Si aucun fournisseur n’est défini, il SqlDataSource utilise le fournisseur ADO.NET pour Microsoft SQL Server, par défaut.

connectionString
String

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

selectCommand
String

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

Remarques

Étant donné que différents produits de base de données utilisent différentes variétés de SQL, la syntaxe selectCommand dépend du fournisseur de ADO.NET actuel utilisé, qui est identifié par le providerName paramètre. Si la chaîne SQL est une requête ou une commande paramétrable, 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 le System.Data.Odbc ou l’espace System.Data.OleDbré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 à