Taal

SqlDataSource Constructors

Definitie

Initialiseert een nieuw exemplaar van de SqlDataSource klasse.

Overloads

Name Description
SqlDataSource()

Initialiseert een nieuw exemplaar van de SqlDataSource klasse.

SqlDataSource(String, String)

Initialiseert een nieuw exemplaar van de klasse SqlDataSource met de opgegeven verbindingsreeks en selecteer de opdracht.

SqlDataSource(String, String, String)

Initialiseert een nieuw exemplaar van de klasse SqlDataSource met de opgegeven verbindingsreeks en selecteer de opdracht.

SqlDataSource()

Initialiseert een nieuw exemplaar van de SqlDataSource klasse.

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

Zie ook

Van toepassing op

SqlDataSource(String, String)

Initialiseert een nieuw exemplaar van de klasse SqlDataSource met de opgegeven verbindingsreeks en selecteer de opdracht.

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)

Parameters

connectionString
String

De verbindingsreeks gebruikt om verbinding te maken met de onderliggende database.

selectCommand
String

De SQL-query die wordt gebruikt om gegevens op te halen uit de onderliggende database. Als de SQL-query een geparameteriseerde SQL-tekenreeks is, moet u mogelijk objecten toevoegen Parameter aan de SelectParameters verzameling.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een SqlDataSource besturingselement maakt met behulp van de SqlDataSource constructor. Het voorbeeld is ongebruikelijk dat het SqlDataSource besturingselement niet wordt gebruikt op een webpagina met webformulieren, maar in de implementatie van een object in de middelste laag als een eenvoudige manier voor een zakelijk object om te communiceren met een database. In het voorbeeld wordt een verbindingsreeks gebruikt die is opgeslagen in het Web.config-bestand.

Dit codevoorbeeld maakt deel uit van een groter voorbeeld voor de ObjectDataSource klasse.

// 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

Opmerkingen

Omdat verschillende databaseproducten verschillende soorten SQL gebruiken, is de syntaxis voor selectCommand afhankelijk van de huidige ADO.NET provider die wordt gebruikt, die wordt geïdentificeerd door de eigenschap ProviderName. Als de SQL-tekenreeks een geparameteriseerde query of opdracht is, is de tijdelijke aanduiding van de parameter ook afhankelijk van de ADO.NET provider die wordt gebruikt. Als de provider bijvoorbeeld de System.Data.SqlClientstandaardprovider voor de SqlDataSource klasse is, is '@parameterName'de tijdelijke aanduiding van de parameter. Als de provider echter is ingesteld op de System.Data.Odbc of de System.Data.OleDb, is de tijdelijke aanduiding van de parameter '?'. Zie Parameters gebruiken met het besturingselement SqlDataSource voor meer informatie over geparameteriseerde SQL-query's en -opdrachten.

De SelectCommand waarde kan een SQL-tekenreeks of de naam van een opgeslagen procedure zijn, als de gegevensbron opgeslagen procedures ondersteunt.

Zie ook

Van toepassing op

SqlDataSource(String, String, String)

Initialiseert een nieuw exemplaar van de klasse SqlDataSource met de opgegeven verbindingsreeks en selecteer de opdracht.

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)

Parameters

providerName
String

De naam van de gegevensprovider die door de SqlDataSource gegevensprovider wordt gebruikt. Als er geen provider is ingesteld, gebruikt de SqlDataSource standaard de ADO.NET-provider voor Microsoft SQL Server.

connectionString
String

De verbindingsreeks gebruikt om verbinding te maken met de onderliggende database.

selectCommand
String

De SQL-query die wordt gebruikt om gegevens op te halen uit de onderliggende database. Als de SQL-query een geparameteriseerde SQL-tekenreeks is, moet u mogelijk objecten toevoegen Parameter aan de SelectParameters verzameling.

Opmerkingen

Omdat verschillende databaseproducten verschillende soorten SQL gebruiken, is de syntaxis van selectCommand afhankelijk van de huidige ADO.NET provider die wordt gebruikt, die wordt geïdentificeerd door de parameter providerName. Als de SQL-tekenreeks een geparameteriseerde query of opdracht is, is de tijdelijke aanduiding van de parameter ook afhankelijk van de ADO.NET provider die wordt gebruikt. Als de provider bijvoorbeeld de standaardprovider voor de System.Data.SqlClient klasse isSqlDataSource, is '@parameterName'de tijdelijke aanduiding van de parameter. Als de provider echter is ingesteld op de System.Data.Odbc of de System.Data.OleDb, is de tijdelijke aanduiding van de parameter '?'. Zie Parameters gebruiken met het besturingselement SqlDataSource voor meer informatie over geparameteriseerde SQL-query's en -opdrachten.

De SelectCommand eigenschap kan een SQL-tekenreeks of de naam van een opgeslagen procedure zijn, als de gegevensbron opgeslagen procedures ondersteunt.

Zie ook

Van toepassing op