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

  • Ссылка

Определение

Пространство имен:
System.Web.UI.WebControls
Сборка:
System.Web.dll

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

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

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