SqlDataSource Konstruktory
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Inicializuje novou instanci SqlDataSource třídy.
Přetížení
SqlDataSource() |
Inicializuje novou instanci SqlDataSource třídy. |
SqlDataSource(String, String) |
Inicializuje novou instanci SqlDataSource třídy pomocí zadaného připojovacího řetězce a vybrat příkaz. |
SqlDataSource(String, String, String) |
Inicializuje novou instanci SqlDataSource třídy pomocí zadaného připojovacího řetězce a vybrat příkaz. |
SqlDataSource()
Inicializuje novou instanci SqlDataSource třídy.
public:
SqlDataSource();
public SqlDataSource ();
Public Sub New ()
Viz také
- SqlDataSourceView
- AccessDataSource
- DataSourceControl
- Ovládací prvky webového serveru zdroje dat
- Přehled ovládacího prvku webového serveru SqlDataSource
Platí pro
SqlDataSource(String, String)
Inicializuje novou instanci SqlDataSource třídy pomocí zadaného připojovacího řetězce a vybrat příkaz.
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ý řetězec SQL, možná budete muset do SelectParameters kolekce přidat Parameter objekty.
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 SqlDataSource , že ovládací prvek se nepoužívá na stránce webových formulářů, ale v implementaci objektu střední vrstvy jako jednoduchý způsob interakce obchodního objektu s databází. Příklad používá připojovací řetězec, který je uložen v souboru Web.config.
Tento příklad kódu je součástí většího příkladu ObjectDataSource pro třídu.
// 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é druhy SQL, syntaxe pro selectCommand
závisí na aktuálním použitém zprostředkovateli 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 zprostředkovateli ADO.NET. Pokud je System.Data.SqlClientnapříklad zprostředkovatelem , 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 najdete 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é
- ConnectionString
- SelectCommand
- SelectParameters
- Ovládací prvky webového serveru zdroje dat
- Přehled ovládacího prvku webového serveru SqlDataSource
Platí pro
SqlDataSource(String, String, String)
Inicializuje novou instanci SqlDataSource třídy pomocí zadaného připojovacího řetězce a vybrat příkaz.
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 zprostředkovatel ADO.NET pro Microsoft SQL Server ve výchozím nastavení.
- 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ý řetězec SQL, možná budete muset do SelectParameters kolekce přidat Parameter objekty.
Poznámky
Vzhledem k tomu, že různé databázové produkty používají různé druhy SQL, syntaxe selectCommand
závisí na aktuálním použitém zprostředkovateli 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 zprostředkovateli 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 najdete 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é
- ProviderName
- ConnectionString
- SelectCommand
- SelectParameters
- Ovládací prvky webového serveru zdroje dat
- Přehled ovládacího prvku webového serveru SqlDataSource