Поделиться через


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

Определение

Инициализирует новый экземпляр класса SqlDataSource.

Перегрузки

SqlDataSource()

Инициализирует новый экземпляр класса SqlDataSource.

SqlDataSource(String, String)

Инициализирует новый экземпляр класса SqlDataSource с заданной строкой подключения и командой Select.

SqlDataSource(String, String, String)

Инициализирует новый экземпляр класса SqlDataSource с заданной строкой подключения и командой Select.

SqlDataSource()

Инициализирует новый экземпляр класса SqlDataSource.

public:
 SqlDataSource();
public SqlDataSource ();
Public Sub New ()

См. также раздел

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

SqlDataSource(String, String)

Инициализирует новый экземпляр класса SqlDataSource с заданной строкой подключения и командой 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)

Параметры

connectionString
String

Строка, используемая для подключения к основной базе данных.

selectCommand
String

SQL-запрос используется для извлечения данных из основной базы данных. Если SQL-запрос является параметризованной SQL-строкой, может понадобиться добавить объекты Parameter в коллекцию SelectParameters.

Примеры

В следующем примере кода показано, как создать SqlDataSource элемент управления с помощью конструктора SqlDataSource . Пример является необычным SqlDataSource тем, что элемент управления используется не на странице веб-форм, а в реализации объекта среднего уровня в качестве простого способа взаимодействия бизнес-объекта с базой данных. В примере используется строка подключения, хранящаяся в файле Web.config.

Этот пример входит в состав более крупного примера использования класса ObjectDataSource.

// 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 . Если строка SQL представляет собой параметризованный запрос или команду, заполнитель параметра также зависит от используемого поставщика ADO.NET. Например, если поставщиком является System.Data.SqlClient, который является поставщиком по умолчанию для SqlDataSource класса, заполнитель параметра — '@parameterName'. Однако если поставщик имеет значение System.Data.Odbc или System.Data.OleDb, заполнителем параметра будет '?'. Дополнительные сведения о параметризованных запросах и командах SQL см. в разделе Использование параметров с элементом управления SqlDataSource.

Значением SelectCommand может быть строка SQL или имя хранимой процедуры, если источник данных поддерживает хранимые процедуры.

См. также раздел

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

SqlDataSource(String, String, String)

Инициализирует новый экземпляр класса SqlDataSource с заданной строкой подключения и командой 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)

Параметры

providerName
String

Имя поставщика данных, используемого объектом SqlDataSource. Если поставщик не задан, объект SqlDataSource использует по умолчанию поставщик ADO.NET для Microsoft SQL Server.

connectionString
String

Строка, используемая для подключения к основной базе данных.

selectCommand
String

SQL-запрос используется для извлечения данных из основной базы данных. Если SQL-запрос является параметризованной SQL-строкой, может понадобиться добавить объекты Parameter в коллекцию SelectParameters.

Комментарии

Так как в разных продуктах базы данных используются разные разновидности SQL, синтаксис зависит от текущего selectCommand поставщика ADO.NET, который определяется параметром providerName . Если строка SQL представляет собой параметризованный запрос или команду, заполнитель параметра также зависит от используемого поставщика ADO.NET. Например, если поставщик — System.Data.SqlClient, который является поставщиком по умолчанию для SqlDataSource класса, заполнитель параметра — '@parameterName'. Однако если поставщик имеет значение System.Data.Odbc или System.Data.OleDb, заполнителем параметра будет '?'. Дополнительные сведения о параметризованных запросах и командах SQL см. в разделе Использование параметров с элементом управления SqlDataSource.

Свойство SelectCommand может быть строкой SQL или именем хранимой процедуры, если источник данных поддерживает хранимые процедуры.

См. также раздел

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