SqlDataSource Costruttori
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Inizializza una nuova istanza della classe SqlDataSource.
Overload
SqlDataSource() |
Inizializza una nuova istanza della classe SqlDataSource. |
SqlDataSource(String, String) |
Inizializza una nuova istanza della classe SqlDataSource con la stringa di connessione specificata e il comando Seleziona. |
SqlDataSource(String, String, String) |
Inizializza una nuova istanza della classe SqlDataSource con la stringa di connessione specificata e il comando Seleziona. |
SqlDataSource()
Inizializza una nuova istanza della classe SqlDataSource.
public:
SqlDataSource();
public SqlDataSource ();
Public Sub New ()
Vedi anche
- SqlDataSourceView
- AccessDataSource
- DataSourceControl
- Controlli server Web dell'origine dati
- Panoramica del controllo server Web SqlDataSource
Si applica a
SqlDataSource(String, String)
Inizializza una nuova istanza della classe SqlDataSource con la stringa di connessione specificata e il comando Seleziona.
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)
Parametri
- connectionString
- String
Stringa di connessione utilizzata per la connessione al database sottostante.
- selectCommand
- String
Query SQL utilizzata per recuperare dati dal database sottostante. Se la query SQL è una stringa SQL con parametri, potrebbe essere necessario aggiungere oggetti Parameter all'insieme SelectParameters.
Esempio
Nell'esempio di codice seguente viene illustrato come creare un SqlDataSource controllo usando il SqlDataSource costruttore . L'esempio è insolito in quanto il SqlDataSource controllo viene usato non in una pagina Web Form, ma nell'implementazione di un oggetto di livello intermedio come modo semplice per un oggetto business di interagire con un database. Nell'esempio viene utilizzata una stringa di connessione archiviata nel file Web.config.
Questo esempio di codice fa parte di un esempio più ampio fornito per la ObjectDataSource classe .
// 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
Commenti
Poiché i diversi prodotti di database usano diverse varietà di SQL, la sintassi per selectCommand
dipende dal provider di ADO.NET corrente utilizzato, identificato dalla ProviderName proprietà . Se la stringa SQL è una query o un comando con parametri, anche il segnaposto del parametro dipenderà dal provider ADO.NET in uso. Ad esempio, se il provider è System.Data.SqlClient, che è il provider predefinito per la SqlDataSource classe , il segnaposto del parametro è '@parameterName'
. Tuttavia, se il provider è impostato su System.Data.Odbc o System.Data.OleDb, il segnaposto del parametro è '?'
. Per altre informazioni sulle query e i comandi SQL con parametri, vedere Uso di parametri con il controllo SqlDataSource.
Il SelectCommand valore può essere una stringa SQL o il nome di una stored procedure, se l'origine dati supporta stored procedure.
Vedi anche
- ConnectionString
- SelectCommand
- SelectParameters
- Controlli server Web dell'origine dati
- Panoramica del controllo server Web SqlDataSource
Si applica a
SqlDataSource(String, String, String)
Inizializza una nuova istanza della classe SqlDataSource con la stringa di connessione specificata e il comando Seleziona.
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)
Parametri
- providerName
- String
Nome del provider di dati utilizzato dall'oggetto SqlDataSource. Per impostazione predefinita, se non viene impostato alcun provider, l'oggetto SqlDataSource utilizza il provider ADO.NET per Microsoft SQL Server.
- connectionString
- String
Stringa di connessione utilizzata per la connessione al database sottostante.
- selectCommand
- String
Query SQL utilizzata per recuperare dati dal database sottostante. Se la query SQL è una stringa SQL con parametri, potrebbe essere necessario aggiungere oggetti Parameter all'insieme SelectParameters.
Commenti
Poiché i diversi prodotti di database usano diverse varietà di SQL, la sintassi di selectCommand
dipende dal provider di ADO.NET corrente utilizzato, identificato dal providerName
parametro . Se la stringa SQL è una query o un comando con parametri, anche il segnaposto del parametro dipenderà dal provider ADO.NET in uso. Ad esempio, se il provider è System.Data.SqlClient, che è il provider predefinito per la SqlDataSource classe , il segnaposto del parametro è '@parameterName'
. Tuttavia, se il provider è impostato su System.Data.Odbc o System.Data.OleDb, il segnaposto del parametro è '?'
. Per altre informazioni sulle query e i comandi SQL con parametri, vedere Uso di parametri con il controllo SqlDataSource.
La SelectCommand proprietà può essere una stringa SQL o il nome di una stored procedure, se l'origine dati supporta stored procedure.
Vedi anche
- ProviderName
- ConnectionString
- SelectCommand
- SelectParameters
- Controlli server Web dell'origine dati
- Panoramica del controllo server Web SqlDataSource