SqlDataSource Konstruktoren

public:
 SqlDataSource();

public SqlDataSource();

Public Sub New ()

Weitere Informationen

• SqlDataSourceView
• AccessDataSource
• DataSourceControl
• Datenquellenwebserversteuerelemente
• Übersicht über sqlDataSource-Webserversteuerelemente

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

Beispiele

Im folgenden Codebeispiel wird das Erstellen eines SqlDataSource Steuerelements mithilfe des SqlDataSource Konstruktors veranschaulicht. Das Beispiel ist ungewöhnlich, dass das SqlDataSource Steuerelement nicht auf einer Webseite von Formularen verwendet wird, sondern in der Implementierung eines Objekts auf mittlerer Ebene als einfache Möglichkeit für die Interaktion mit einer Datenbank für ein Geschäftsobjekt. Im Beispiel wird eine Verbindungszeichenfolge verwendet, die in der datei Web.config 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 unterschiedliche Datenbankprodukte unterschiedliche SQL-Varianten verwenden, hängt die Syntax von selectCommand dem aktuell verwendeten ADO.NET Anbieter ab, der von der ProviderName Eigenschaft identifiziert wird. Wenn es sich bei der SQL-Zeichenfolge um eine parametrisierte Abfrage oder einen parametrisierten Befehl handelt, hängt der Platzhalter des Parameters auch vom verwendeten ADO.NET Anbieter ab. Wenn der Anbieter beispielsweise der System.Data.SqlClientStandardanbieter für die SqlDataSource Klasse ist, lautet '@parameterName'der Platzhalter des Parameters . Wenn der Anbieter jedoch auf den System.Data.Odbc oder den System.Data.OleDb, der Platzhalter des Parameters festgelegt ist, lautet '?'der Platzhalter des Parameters . Weitere Informationen zu parametrisierten 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.

Weitere Informationen

• ConnectionString
• SelectCommand
• SelectParameters
• Datenquellenwebserversteuerelemente
• Übersicht über sqlDataSource-Webserversteuerelemente

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

Hinweise

Da unterschiedliche Datenbankprodukte unterschiedliche SQL-Varianten verwenden, hängt die Syntax von selectCommand der verwendeten ADO.NET Anbieter ab, die vom providerName Parameter identifiziert wird. Wenn es sich bei der SQL-Zeichenfolge um eine parametrisierte Abfrage oder einen parametrisierten Befehl handelt, hängt der Platzhalter des Parameters auch 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 den System.Data.Odbc oder den System.Data.OleDb, der Platzhalter des Parameters festgelegt ist, lautet '?'der Platzhalter des Parameters . Weitere Informationen zu parametrisierten 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.

Weitere Informationen

• ProviderName
• ConnectionString
• SelectCommand
• SelectParameters
• Datenquellenwebserversteuerelemente
• Übersicht über sqlDataSource-Webserversteuerelemente