SqlDataSource Конструкторы

Определение

Инициализирует новый экземпляр класса SqlDataSource.Initializes a new instance of the SqlDataSource class.

Перегрузки

SqlDataSource()

Инициализирует новый экземпляр класса SqlDataSource.Initializes a new instance of the SqlDataSource class.

SqlDataSource(String, String)

Инициализирует новый экземпляр класса SqlDataSource с заданной строкой подключения и командой Select.Initializes a new instance of the SqlDataSource class with the specified connection string and Select command.

SqlDataSource(String, String, String)

Инициализирует новый экземпляр класса SqlDataSource с заданной строкой подключения и командой Select.Initializes a new instance of the SqlDataSource class with the specified connection string and Select command.

SqlDataSource(String, String)

Инициализирует новый экземпляр класса SqlDataSource с заданной строкой подключения и командой Select.Initializes a new instance of the SqlDataSource class with the specified connection string and Select command.

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)

Параметры

connectionString
String

Строка, используемая для подключения к основной базе данных.The connection string used to connect to the underlying database.

selectCommand
String

SQL-запрос используется для извлечения данных из основной базы данных.The SQL query used to retrieve data from the underlying database. Если SQL-запрос является параметризованной SQL-строкой, может понадобиться добавить объекты Parameter в коллекцию SelectParameters.If the SQL query is a parameterized SQL string, you might need to add Parameter objects to the SelectParameters collection.

Примеры

В следующем примере кода показано, как создать SqlDataSource элемент управления SqlDataSource с помощью конструктора.The following code example demonstrates how to create a SqlDataSource control using the SqlDataSource constructor. Пример нетипичен в том смысле SqlDataSource , что элемент управления используется не на странице веб-форм, но в реализации объекта среднего уровня как простой способ взаимодействия бизнес-объекта с базой данных.The example is unusual in that the SqlDataSource control is being used not on a Web Forms page, but in the implementation of a middle-tier object as a simple way for a business object to interact with a database. В примере используется строка подключения, которая хранится в файле Web. config.The example uses a connection string that is stored in the Web.config file.

Этот пример кода является частью большого примера, ObjectDataSource приведенного для класса.This code example is part of a larger example provided for the ObjectDataSource class.

// 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

Комментарии

Поскольку разные продукты базы данных используют различные разновидности SQL, синтаксис для selectCommand зависит от текущего используемого поставщика ADO.NET, который определяется ProviderName свойством.Because different database products use different varieties of SQL, the syntax for selectCommand depends on the current ADO.NET provider being used, which is identified by the ProviderName property. Если строка SQL представляет собой параметризованный запрос или команду, заполнитель параметра также зависит от используемого поставщика ADO.NET.If the SQL string is a parameterized query or command, the placeholder of the parameter also depends on the ADO.NET provider being used. Например, если поставщик является System.Data.SqlClientпоставщиком по умолчанию SqlDataSource для класса, заполнитель параметра имеет '@parameterName'значение.For example, if the provider is the System.Data.SqlClient, which is the default provider for the SqlDataSource class, the placeholder of the parameter is '@parameterName'. Однако если поставщику присвоено значение System.Data.Odbc System.Data.OleDbили, заполнитель параметра имеет '?'значение.However, if the provider is set to the System.Data.Odbc or the System.Data.OleDb, the placeholder of the parameter is '?'. Дополнительные сведения о параметризованных запросах SQL и командах см. в разделе Использование параметров с элементом управления SqlDataSource.For more information about parameterized SQL queries and commands, see Using Parameters with the SqlDataSource Control.

SelectCommand Значение может быть строкой SQL или именем хранимой процедуры, если источник данных поддерживает хранимые процедуры.The SelectCommand value can be an SQL string or the name of a stored procedure, if the data source supports stored procedures.

Дополнительно

SqlDataSource(String, String, String)

Инициализирует новый экземпляр класса SqlDataSource с заданной строкой подключения и командой Select.Initializes a new instance of the SqlDataSource class with the specified connection string and Select command.

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)

Параметры

providerName
String

Имя поставщика данных, используемого объектом SqlDataSource.The name of the data provider that the SqlDataSource uses. Если поставщик не задан, объект SqlDataSource использует по умолчанию поставщик ADO.NET для Microsoft SQL Server.If no provider is set, the SqlDataSource uses the ADO.NET provider for Microsoft SQL Server, by default.

connectionString
String

Строка, используемая для подключения к основной базе данных.The connection string used to connect to the underlying database.

selectCommand
String

SQL-запрос используется для извлечения данных из основной базы данных.The SQL query used to retrieve data from the underlying database. Если SQL-запрос является параметризованной SQL-строкой, может понадобиться добавить объекты Parameter в коллекцию SelectParameters.If the SQL query is a parameterized SQL string, you might need to add Parameter objects to the SelectParameters collection.

Комментарии

Поскольку разные продукты базы данных используют различные разновидности SQL, синтаксис selectCommand зависит от текущего используемого поставщика ADO.NET, который определяется providerName параметром.Because different database products use different varieties of SQL, the syntax of selectCommand depends on the current ADO.NET provider being used, which is identified by the providerName parameter. Если строка SQL представляет собой параметризованный запрос или команду, заполнитель параметра также зависит от используемого поставщика ADO.NET.If the SQL string is a parameterized query or command, the placeholder of the parameter also depends on the ADO.NET provider being used. Например, если поставщик является System.Data.SqlClientпоставщиком по умолчанию SqlDataSource для класса, заполнитель параметра имеет '@parameterName'значение.For example, if the provider is System.Data.SqlClient, which is the default provider for the SqlDataSource class, the placeholder of the parameter is '@parameterName'. Однако если поставщику присвоено значение System.Data.Odbc System.Data.OleDbили, заполнитель параметра имеет '?'значение.However, if the provider is set to the System.Data.Odbc or the System.Data.OleDb, the placeholder of the parameter is '?'. Дополнительные сведения о параметризованных запросах SQL и командах см. в разделе Использование параметров с элементом управления SqlDataSource.For more information about parameterized SQL queries and commands, see Using Parameters with the SqlDataSource Control.

SelectCommand Свойство может быть строкой SQL или именем хранимой процедуры, если источник данных поддерживает хранимые процедуры.The SelectCommand property can be an SQL string or the name of a stored procedure, if the data source supports stored procedures.

Дополнительно

Применяется к