Język

SqlDataSource Konstruktory

Definicja

Inicjuje nowe wystąpienie klasy SqlDataSource.

Przeciążenia

Nazwa Opis
SqlDataSource()

Inicjuje nowe wystąpienie klasy SqlDataSource.

SqlDataSource(String, String)

Inicjuje nowe wystąpienie SqlDataSource klasy z określonymi parametrami połączenia i polecenie Select.

SqlDataSource(String, String, String)

Inicjuje nowe wystąpienie SqlDataSource klasy z określonymi parametrami połączenia i polecenie Select.

SqlDataSource()

Inicjuje nowe wystąpienie klasy SqlDataSource.

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

Zobacz też

Dotyczy

SqlDataSource(String, String)

Inicjuje nowe wystąpienie SqlDataSource klasy z określonymi parametrami połączenia i polecenie 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)

Parametry

connectionString
String

Parametry połączenia używane do nawiązywania połączenia z bazową bazą danych.

selectCommand
String

Zapytanie SQL używane do pobierania danych z bazowej bazy danych. Jeśli zapytanie SQL jest sparametryzowanym ciągiem SQL, może być konieczne dodanie Parameter obiektów do SelectParameters kolekcji.

Przykłady

W poniższym przykładzie kodu pokazano, jak utworzyć kontrolkę SqlDataSource przy użyciu konstruktora SqlDataSource . Przykład jest nietypowy, ponieważ kontrolka SqlDataSource jest używana nie na stronie formularzy sieci Web, ale w implementacji obiektu warstwy środkowej jako prostego sposobu interakcji obiektu biznesowego z bazą danych. W przykładzie użyto parametrów połączenia przechowywanych w pliku Web.config.

Ten przykład kodu jest częścią większego przykładu udostępnionego dla klasy ObjectDataSource.

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

Uwagi

Ponieważ różne produkty bazy danych używają różnych odmian języka SQL, składnia zależy selectCommand od używanego ProviderName dostawcy ADO.NET, który jest identyfikowany przez właściwość. Jeśli ciąg SQL jest sparametryzowanym zapytaniem lub poleceniem, symbol zastępczy parametru również zależy od używanego dostawcy ADO.NET. Jeśli na przykład dostawca jest dostawcą System.Data.SqlClient, który jest domyślnym dostawcą klasy SqlDataSource , symbol zastępczy parametru to '@parameterName'. Jeśli jednak dostawca jest ustawiony na System.Data.Odbc wartość lub System.Data.OleDb, symbol zastępczy parametru to '?'. Aby uzyskać więcej informacji na temat sparametryzowanych zapytań SQL i poleceń, zobacz Using Parameters with the SqlDataSource Control (Używanie parametrów z kontrolką SqlDataSource).

Wartość SelectCommand może być ciągiem SQL lub nazwą procedury składowanej, jeśli źródło danych obsługuje procedury składowane.

Zobacz też

Dotyczy

SqlDataSource(String, String, String)

Inicjuje nowe wystąpienie SqlDataSource klasy z określonymi parametrami połączenia i polecenie 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)

Parametry

providerName
String

Nazwa dostawcy danych, którego SqlDataSource używa. Jeśli żaden dostawca nie jest ustawiony, SqlDataSource domyślnie używa dostawcy ADO.NET dla programu Microsoft SQL Server.

connectionString
String

Parametry połączenia używane do nawiązywania połączenia z bazową bazą danych.

selectCommand
String

Zapytanie SQL używane do pobierania danych z bazowej bazy danych. Jeśli zapytanie SQL jest sparametryzowanym ciągiem SQL, może być konieczne dodanie Parameter obiektów do SelectParameters kolekcji.

Uwagi

Ponieważ różne produkty bazy danych używają różnych odmian języka SQL, składnia selectCommand zależy od używanego bieżącego dostawcy ADO.NET, który jest identyfikowany przez providerName parametr . Jeśli ciąg SQL jest sparametryzowanym zapytaniem lub poleceniem, symbol zastępczy parametru również zależy od używanego dostawcy ADO.NET. Jeśli na przykład dostawca to System.Data.SqlClient, który jest domyślnym dostawcą klasy SqlDataSource , symbol zastępczy parametru to '@parameterName'. Jeśli jednak dostawca jest ustawiony na System.Data.Odbc wartość lub System.Data.OleDb, symbol zastępczy parametru to '?'. Aby uzyskać więcej informacji na temat sparametryzowanych zapytań SQL i poleceń, zobacz Using Parameters with the SqlDataSource Control (Używanie parametrów z kontrolką SqlDataSource).

Właściwość SelectCommand może być ciągiem SQL lub nazwą procedury składowanej, jeśli źródło danych obsługuje procedury składowane.

Zobacz też

Dotyczy