Udostępnij za pośrednictwem

SqlDataSource Konstruktory

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls
Zestaw:
System.Web.dll

Inicjuje nowe wystąpienie klasy SqlDataSource.

Przeciążenia

SqlDataSource()

Inicjuje nowe wystąpienie klasy SqlDataSource.
SqlDataSource(String, String)

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

Inicjuje SqlDataSource nowe wystąpienie 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 SqlDataSource nowe wystąpienie 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ż SqlDataSource kontrolka jest używana nie na stronie formularzy sieci Web, ale w implementacji obiektu warstwy środkowej jako prosty sposób 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 podanego ObjectDataSource dla klasy.

// 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 selectCommand zależy od używanego bieżącego dostawcy ADO.NET, który jest identyfikowany przez ProviderName właściwość. Jeśli ciąg SQL jest sparametryzowanym zapytaniem lub poleceniem, symbol zastępczy parametru zależy również 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 za pomocą kontrolki 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 SqlDataSource nowe wystąpienie 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 używanego przez dostawcę SqlDataSource danych. Jeśli 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 providerName bieżącego dostawcy ADO.NET, który jest identyfikowany przez parametr . Jeśli ciąg SQL jest sparametryzowanym zapytaniem lub poleceniem, symbol zastępczy parametru zależy również 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 za pomocą kontrolki 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