Sdílet prostřednictvím

SqlDataSource Konstruktory

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Inicializuje novou instanci SqlDataSource třídy.

Přetížení

Name Description
SqlDataSource()

Inicializuje novou instanci SqlDataSource třídy.
SqlDataSource(String, String)

Inicializuje novou instanci třídy pomocí zadaného připojovacího SqlDataSource řetězce a příkazu Select.
SqlDataSource(String, String, String)

Inicializuje novou instanci třídy pomocí zadaného připojovacího SqlDataSource řetězce a příkazu Select.

SqlDataSource()

Inicializuje novou instanci SqlDataSource třídy.

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

Viz také

Platí pro

SqlDataSource(String, String)

Inicializuje novou instanci třídy pomocí zadaného připojovacího SqlDataSource řetězce a příkazu 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

Připojovací řetězec použitý k připojení k podkladové databázi.

selectCommand
String

Dotaz SQL použitý k načtení dat z podkladové databáze. Pokud je dotaz SQL parametrizovaným řetězcem SQL, budete možná muset do kolekce přidat Parameter objekty SelectParameters .

Příklady

Následující příklad kódu ukazuje, jak vytvořit SqlDataSource ovládací prvek pomocí konstruktoru SqlDataSource . Příklad je neobvyklý v tom, že SqlDataSource ovládací prvek se nepoužívá na stránce webových formulářů, ale při implementaci objektu střední vrstvy jako jednoduchý způsob, jak obchodní objekt pracovat s databází. Příklad používá připojovací řetězec uložený v souboru Web.config.

Tento příklad kódu je součástí většího příkladu uvedeného pro třídu 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

Poznámky

Vzhledem k tomu, že různé databázové produkty používají různé odrůdy SQL, syntaxe selectCommand závisí na aktuálním používaném poskytovateli ADO.NET, který je identifikován ProviderName vlastností. Pokud je řetězec SQL parametrizovaný dotaz nebo příkaz, zástupný symbol parametru závisí také na použitém poskytovateli ADO.NET. Pokud je například zprostředkovatel , což je System.Data.SqlClientvýchozí zprostředkovatel pro SqlDataSource třídu, zástupný symbol parametru je '@parameterName'. Pokud je však zprostředkovatel nastaven na System.Data.Odbc hodnotu nebo System.Data.OleDb, zástupný symbol parametru je '?'. Další informace o parametrizovaných dotazech a příkazech SQL naleznete v tématu Použití parametrů s ovládacím prvku SqlDataSource.

Hodnota SelectCommand může být řetězec SQL nebo název uložené procedury, pokud zdroj dat podporuje uložené procedury.

Viz také

Platí pro

SqlDataSource(String, String, String)

Inicializuje novou instanci třídy pomocí zadaného připojovacího SqlDataSource řetězce a příkazu 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

Název zprostředkovatele dat, který používá SqlDataSource . Pokud není nastavený žádný zprostředkovatel, SqlDataSource použije ve výchozím nastavení poskytovatele ADO.NET pro Microsoft SQL Server.

connectionString
String

Připojovací řetězec použitý k připojení k podkladové databázi.

selectCommand
String

Dotaz SQL použitý k načtení dat z podkladové databáze. Pokud je dotaz SQL parametrizovaným řetězcem SQL, budete možná muset do kolekce přidat Parameter objekty SelectParameters .

Poznámky

Vzhledem k tomu, že různé databázové produkty používají různé odrůdy SQL, syntaxe selectCommand závisí na aktuálním používaném poskytovateli ADO.NET, který je identifikován parametrem providerName . Pokud je řetězec SQL parametrizovaný dotaz nebo příkaz, zástupný symbol parametru závisí také na použitém poskytovateli ADO.NET. Pokud je System.Data.SqlClientnapříklad zprostředkovatel , což je výchozí zprostředkovatel pro SqlDataSource třídu, zástupný symbol parametru je '@parameterName'. Pokud je však zprostředkovatel nastaven na System.Data.Odbc hodnotu nebo System.Data.OleDb, zástupný symbol parametru je '?'. Další informace o parametrizovaných dotazech a příkazech SQL naleznete v tématu Použití parametrů s ovládacím prvku SqlDataSource.

Vlastnost SelectCommand může být řetězec SQL nebo název uložené procedury, pokud zdroj dat podporuje uložené procedury.

Viz také

Platí pro