Share via


SqlDataSource Costruttori

Definizione

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

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 Forms, 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 con parametri SQL, 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

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 con parametri SQL, 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

Si applica a