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
| Nome | Descrizione |
|---|---|
| SqlDataSource() |
Inizializza una nuova istanza della classe SqlDataSource. |
| SqlDataSource(String, String) |
Inizializza una nuova istanza della SqlDataSource classe con la stringa di connessione specificata e il comando Select. |
| SqlDataSource(String, String, String) |
Inizializza una nuova istanza della SqlDataSource classe con la stringa di connessione specificata e il comando Select. |
SqlDataSource()
Inizializza una nuova istanza della classe SqlDataSource.
public:
SqlDataSource();
public SqlDataSource();
Public Sub New ()
Vedi anche
- SqlDataSourceView
- AccessDataSource
- DataSourceControl
- Controlli server Web origine dati
- Panoramica del controllo server Web SqlDataSource
Si applica a
SqlDataSource(String, String)
Inizializza una nuova istanza della SqlDataSource classe con la stringa di connessione specificata e il comando 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)
Parametri
- connectionString
- String
Stringa di connessione utilizzata per connettersi al database sottostante.
- selectCommand
- String
Query SQL usata per recuperare i dati dal database sottostante. Se la query SQL è una stringa SQL con parametri, potrebbe essere necessario aggiungere Parameter oggetti alla SelectParameters raccolta.
Esempio
Nell'esempio di codice seguente viene illustrato come creare un SqlDataSource controllo usando il SqlDataSource costruttore . L'esempio è insolito perché il SqlDataSource controllo non viene usato in una pagina Web Form, ma nell'implementazione di un oggetto di livello intermedio come un modo semplice per 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é 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, il segnaposto del parametro dipende anche dal provider ADO.NET utilizzato. Ad esempio, se il provider è , System.Data.SqlClientche è 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 origine dati
- Panoramica del controllo server Web SqlDataSource
Si applica a
SqlDataSource(String, String, String)
Inizializza una nuova istanza della SqlDataSource classe con la stringa di connessione specificata e il comando 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)
Parametri
- providerName
- String
Nome del provider di dati utilizzato da SqlDataSource . Se non è impostato alcun provider, SqlDataSource per impostazione predefinita usa il provider di ADO.NET per Microsoft SQL Server.
- connectionString
- String
Stringa di connessione utilizzata per connettersi al database sottostante.
- selectCommand
- String
Query SQL usata per recuperare i dati dal database sottostante. Se la query SQL è una stringa SQL con parametri, potrebbe essere necessario aggiungere Parameter oggetti alla SelectParameters raccolta.
Commenti
Poiché diversi prodotti di database usano diverse varietà di SQL, la sintassi di selectCommand dipende dal provider di ADO.NET corrente usato, identificato dal providerName parametro . Se la stringa SQL è una query o un comando con parametri, il segnaposto del parametro dipende anche dal provider ADO.NET utilizzato. 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 origine dati
- Panoramica del controllo server Web SqlDataSource