SqlDataSource Konstruktoren
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Initialisiert eine neue Instanz der SqlDataSource-Klasse.
Überlädt
SqlDataSource() |
Initialisiert eine neue Instanz der SqlDataSource-Klasse. |
SqlDataSource(String, String) |
Initialisiert eine neue Instanz der SqlDataSource-Klasse mit der angegebenen Verbindungszeichenfolge und dem Select-Befehl. |
SqlDataSource(String, String, String) |
Initialisiert eine neue Instanz der SqlDataSource-Klasse mit der angegebenen Verbindungszeichenfolge und dem Select-Befehl. |
SqlDataSource()
Initialisiert eine neue Instanz der SqlDataSource-Klasse.
public:
SqlDataSource();
public SqlDataSource ();
Public Sub New ()
Siehe auch
- SqlDataSourceView
- AccessDataSource
- DataSourceControl
- Datengebundene Webserversteuerelemente
- Übersicht über das SqlDataSource-Webserversteuerelement
Gilt für
SqlDataSource(String, String)
Initialisiert eine neue Instanz der SqlDataSource-Klasse mit der angegebenen Verbindungszeichenfolge und dem Select-Befehl.
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)
Parameter
- connectionString
- String
Die Verbindungszeichenfolge, mit der die Verbindung zur zugrunde liegenden Datenbank hergestellt wird.
- selectCommand
- String
Die SQL-Abfrage, mit der Daten aus der zugrunde liegenden Datenbank abgerufen werden. Wenn es sich bei der SQL-Abfrage um eine parametrisierte SQL-Zeichenfolge handelt, ist unter Umständen das Hinzufügen von Parameter-Objekten zur SelectParameters-Auflistung erforderlich.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie ein Steuerelement mithilfe des SqlDataSource Konstruktors erstellt SqlDataSource wird. Das Beispiel ist ungewöhnlich, dass das SqlDataSource Steuerelement nicht auf einer Web Forms Seite verwendet wird, sondern in der Implementierung eines mittleren Objekts als einfache Möglichkeit für eine Interaktion mit einer Datenbank. Im Beispiel wird eine Verbindungszeichenfolge verwendet, die in der Web.config-Datei gespeichert ist.
Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die ObjectDataSource Klasse bereitgestellt wird.
// 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
Hinweise
Da verschiedene Datenbankprodukte verschiedene Arten von SQL verwenden, hängt die Syntax selectCommand
von dem aktuellen ADO.NET Anbieter ab, der von der ProviderName Eigenschaft identifiziert wird. Wenn die SQL-Zeichenfolge eine parametrisierte Abfrage oder ein parametrisierter Befehl ist, hängt der Platzhalter des Parameters ebenfalls vom verwendeten ADO.NET-Anbieter ab. Wenn der Anbieter beispielsweise der Standardanbieter für die SqlDataSource Klasse istSystem.Data.SqlClient, lautet '@parameterName'
der Platzhalter des Parameters . Wenn der Anbieter jedoch auf System.Data.Odbc den oder den System.Data.OleDbPlatzhalter des Parameters '?'
festgelegt ist. Weitere Informationen zu parameterisierten SQL Abfragen und Befehlen finden Sie unter Verwenden von Parametern mit dem SqlDataSource-Steuerelement.
Der SelectCommand Wert kann eine SQL Zeichenfolge oder der Name einer gespeicherten Prozedur sein, wenn die Datenquelle gespeicherte Prozeduren unterstützt.
Siehe auch
- ConnectionString
- SelectCommand
- SelectParameters
- Datengebundene Webserversteuerelemente
- Übersicht über das SqlDataSource-Webserversteuerelement
Gilt für
SqlDataSource(String, String, String)
Initialisiert eine neue Instanz der SqlDataSource-Klasse mit der angegebenen Verbindungszeichenfolge und dem Select-Befehl.
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)
Parameter
- providerName
- String
Der Name des Datenanbieters, der von der SqlDataSource verwendet wird. Wenn kein Anbieter festgelegt ist, verwendet die SqlDataSource standardmäßig den ADO.NET-Anbieter für Microsoft SQL Server.
- connectionString
- String
Die Verbindungszeichenfolge, mit der die Verbindung zur zugrunde liegenden Datenbank hergestellt wird.
- selectCommand
- String
Die SQL-Abfrage, mit der Daten aus der zugrunde liegenden Datenbank abgerufen werden. Wenn es sich bei der SQL-Abfrage um eine parametrisierte SQL-Zeichenfolge handelt, ist unter Umständen das Hinzufügen von Parameter-Objekten zur SelectParameters-Auflistung erforderlich.
Hinweise
Da verschiedene Datenbankprodukte unterschiedliche Arten von SQL verwenden, hängt die Syntax selectCommand
von dem aktuellen ADO.NET Anbieter ab, der providerName
vom Parameter identifiziert wird. Wenn die SQL-Zeichenfolge eine parametrisierte Abfrage oder ein parametrisierter Befehl ist, hängt der Platzhalter des Parameters ebenfalls vom verwendeten ADO.NET-Anbieter ab. Wenn der Anbieter System.Data.SqlClientbeispielsweise der Standardanbieter für die SqlDataSource Klasse ist, lautet '@parameterName'
der Platzhalter des Parameters . Wenn der Anbieter jedoch auf System.Data.Odbc den oder den System.Data.OleDbPlatzhalter des Parameters '?'
festgelegt ist. Weitere Informationen zu parameterisierten SQL Abfragen und Befehlen finden Sie unter Verwenden von Parametern mit dem SqlDataSource-Steuerelement.
Die SelectCommand Eigenschaft kann eine SQL Zeichenfolge oder der Name einer gespeicherten Prozedur sein, wenn die Datenquelle gespeicherte Prozeduren unterstützt.
Siehe auch
- ProviderName
- ConnectionString
- SelectCommand
- SelectParameters
- Datengebundene Webserversteuerelemente
- Übersicht über das SqlDataSource-Webserversteuerelement