SqlDataSource Constructors
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Initialiseert een nieuw exemplaar van de SqlDataSource klasse.
Overloads
| Name | Description |
|---|---|
| SqlDataSource() |
Initialiseert een nieuw exemplaar van de SqlDataSource klasse. |
| SqlDataSource(String, String) |
Initialiseert een nieuw exemplaar van de klasse SqlDataSource met de opgegeven verbindingsreeks en selecteer de opdracht. |
| SqlDataSource(String, String, String) |
Initialiseert een nieuw exemplaar van de klasse SqlDataSource met de opgegeven verbindingsreeks en selecteer de opdracht. |
SqlDataSource()
Initialiseert een nieuw exemplaar van de SqlDataSource klasse.
public:
SqlDataSource();
public SqlDataSource();
Public Sub New ()
Zie ook
- SqlDataSourceView
- AccessDataSource
- DataSourceControl
- Besturingselementen voor webserver van gegevensbron
- Overzicht van SqlDataSource-webserverbeheer
Van toepassing op
SqlDataSource(String, String)
Initialiseert een nieuw exemplaar van de klasse SqlDataSource met de opgegeven verbindingsreeks en selecteer de opdracht.
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)
Parameters
- connectionString
- String
De verbindingsreeks gebruikt om verbinding te maken met de onderliggende database.
- selectCommand
- String
De SQL-query die wordt gebruikt om gegevens op te halen uit de onderliggende database. Als de SQL-query een geparameteriseerde SQL-tekenreeks is, moet u mogelijk objecten toevoegen Parameter aan de SelectParameters verzameling.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u een SqlDataSource besturingselement maakt met behulp van de SqlDataSource constructor. Het voorbeeld is ongebruikelijk dat het SqlDataSource besturingselement niet wordt gebruikt op een webpagina met webformulieren, maar in de implementatie van een object in de middelste laag als een eenvoudige manier voor een zakelijk object om te communiceren met een database. In het voorbeeld wordt een verbindingsreeks gebruikt die is opgeslagen in het Web.config-bestand.
Dit codevoorbeeld maakt deel uit van een groter voorbeeld voor de ObjectDataSource klasse.
// 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
Opmerkingen
Omdat verschillende databaseproducten verschillende soorten SQL gebruiken, is de syntaxis voor selectCommand afhankelijk van de huidige ADO.NET provider die wordt gebruikt, die wordt geïdentificeerd door de eigenschap ProviderName. Als de SQL-tekenreeks een geparameteriseerde query of opdracht is, is de tijdelijke aanduiding van de parameter ook afhankelijk van de ADO.NET provider die wordt gebruikt. Als de provider bijvoorbeeld de System.Data.SqlClientstandaardprovider voor de SqlDataSource klasse is, is '@parameterName'de tijdelijke aanduiding van de parameter. Als de provider echter is ingesteld op de System.Data.Odbc of de System.Data.OleDb, is de tijdelijke aanduiding van de parameter '?'. Zie Parameters gebruiken met het besturingselement SqlDataSource voor meer informatie over geparameteriseerde SQL-query's en -opdrachten.
De SelectCommand waarde kan een SQL-tekenreeks of de naam van een opgeslagen procedure zijn, als de gegevensbron opgeslagen procedures ondersteunt.
Zie ook
- ConnectionString
- SelectCommand
- SelectParameters
- Besturingselementen voor webserver van gegevensbron
- Overzicht van SqlDataSource-webserverbeheer
Van toepassing op
SqlDataSource(String, String, String)
Initialiseert een nieuw exemplaar van de klasse SqlDataSource met de opgegeven verbindingsreeks en selecteer de opdracht.
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)
Parameters
- providerName
- String
De naam van de gegevensprovider die door de SqlDataSource gegevensprovider wordt gebruikt. Als er geen provider is ingesteld, gebruikt de SqlDataSource standaard de ADO.NET-provider voor Microsoft SQL Server.
- connectionString
- String
De verbindingsreeks gebruikt om verbinding te maken met de onderliggende database.
- selectCommand
- String
De SQL-query die wordt gebruikt om gegevens op te halen uit de onderliggende database. Als de SQL-query een geparameteriseerde SQL-tekenreeks is, moet u mogelijk objecten toevoegen Parameter aan de SelectParameters verzameling.
Opmerkingen
Omdat verschillende databaseproducten verschillende soorten SQL gebruiken, is de syntaxis van selectCommand afhankelijk van de huidige ADO.NET provider die wordt gebruikt, die wordt geïdentificeerd door de parameter providerName. Als de SQL-tekenreeks een geparameteriseerde query of opdracht is, is de tijdelijke aanduiding van de parameter ook afhankelijk van de ADO.NET provider die wordt gebruikt. Als de provider bijvoorbeeld de standaardprovider voor de System.Data.SqlClient klasse isSqlDataSource, is '@parameterName'de tijdelijke aanduiding van de parameter. Als de provider echter is ingesteld op de System.Data.Odbc of de System.Data.OleDb, is de tijdelijke aanduiding van de parameter '?'. Zie Parameters gebruiken met het besturingselement SqlDataSource voor meer informatie over geparameteriseerde SQL-query's en -opdrachten.
De SelectCommand eigenschap kan een SQL-tekenreeks of de naam van een opgeslagen procedure zijn, als de gegevensbron opgeslagen procedures ondersteunt.
Zie ook
- ProviderName
- ConnectionString
- SelectCommand
- SelectParameters
- Besturingselementen voor webserver van gegevensbron
- Overzicht van SqlDataSource-webserverbeheer