Aracılığıyla paylaş

SqlDataSource Oluşturucular

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI.WebControls
Bütünleştirilmiş Kod:
System.Web.dll

SqlDataSource sınıfının yeni bir örneğini başlatır.

Aşırı Yüklemeler

SqlDataSource()

SqlDataSource sınıfının yeni bir örneğini başlatır.
SqlDataSource(String, String)

Belirtilen bağlantı dizesi ve Select komutuyla sınıfının yeni bir örneğini SqlDataSource başlatır.
SqlDataSource(String, String, String)

Belirtilen bağlantı dizesi ve Select komutuyla sınıfının yeni bir örneğini SqlDataSource başlatır.

SqlDataSource()

SqlDataSource sınıfının yeni bir örneğini başlatır.

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

Ayrıca bkz.

Şunlara uygulanır

SqlDataSource(String, String)

Belirtilen bağlantı dizesi ve Select komutuyla sınıfının yeni bir örneğini SqlDataSource başlatır.

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)

Parametreler

connectionString
String

Temel alınan veritabanına bağlanmak için kullanılan bağlantı dizesi.

selectCommand
String

Temel alınan veritabanından veri almak için kullanılan SQL sorgusu. SQL sorgusu parametreli bir SQL dizesiyse, koleksiyona SelectParameters nesne eklemeniz Parameter gerekebilir.

Örnekler

Aşağıdaki kod örneği, oluşturucuyu kullanarak bir SqlDataSource denetimin SqlDataSource nasıl oluşturulacağını gösterir. Bu örnek, denetimin SqlDataSource Web Forms sayfasında değil, bir iş nesnesinin veritabanıyla etkileşim kurması için basit bir yol olarak orta katman nesnesinin uygulanmasında olağan dışıdır. Örnek, Web.config dosyasında depolanan bir bağlantı dizesi kullanır.

Bu kod örneği, sınıfı için ObjectDataSource sağlanan daha büyük bir örneğin parçasıdır.

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

Açıklamalar

Farklı veritabanı ürünleri farklı SQL türleri kullandığından, söz selectCommand dizimi özelliği tarafından tanımlanan geçerli ADO.NET sağlayıcısına ProviderName bağlıdır. SQL dizesi parametreli bir sorgu veya komutsa, parametrenin yer tutucusu kullanılan ADO.NET sağlayıcısına da bağlıdır. Örneğin, sağlayıcı System.Data.SqlClientsınıfı için SqlDataSource varsayılan sağlayıcı olan öğesiyse, parametresinin yer tutucusu olur '@parameterName'. Ancak sağlayıcı veya System.Data.OleDbolarak ayarlanırsa System.Data.Odbc parametresinin yer tutucusu olur'?'. Parametreli SQL sorguları ve komutları hakkında daha fazla bilgi için bkz. SqlDataSource Denetimi ile Parametreleri Kullanma.

SelectCommand Veri kaynağı saklı yordamları destekliyorsa değer bir SQL dizesi veya saklı yordamın adı olabilir.

Ayrıca bkz.

Şunlara uygulanır

SqlDataSource(String, String, String)

Belirtilen bağlantı dizesi ve Select komutuyla sınıfının yeni bir örneğini SqlDataSource başlatır.

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)

Parametreler

providerName
String

Kullandığı veri sağlayıcısının SqlDataSource adı. Hiçbir sağlayıcı ayarlı değilse, SqlDataSource varsayılan olarak Microsoft SQL Server için ADO.NET sağlayıcısını kullanır.

connectionString
String

Temel alınan veritabanına bağlanmak için kullanılan bağlantı dizesi.

selectCommand
String

Temel alınan veritabanından veri almak için kullanılan SQL sorgusu. SQL sorgusu parametreli bir SQL dizesiyse, koleksiyona SelectParameters nesne eklemeniz Parameter gerekebilir.

Açıklamalar

Farklı veritabanı ürünleri farklı SQL türleri kullandığından söz dizimi selectCommand , parametresi tarafından tanımlanan geçerli ADO.NET sağlayıcısına providerName bağlıdır. SQL dizesi parametreli bir sorgu veya komutsa, parametrenin yer tutucusu kullanılan ADO.NET sağlayıcısına da bağlıdır. Örneğin, sağlayıcı System.Data.SqlClientsınıfı için SqlDataSource varsayılan sağlayıcı olan ise parametresinin yer tutucusu olur '@parameterName'. Ancak sağlayıcı veya System.Data.OleDbolarak ayarlanırsa System.Data.Odbc parametresinin yer tutucusu olur'?'. Parametreli SQL sorguları ve komutları hakkında daha fazla bilgi için bkz. SqlDataSource Denetimi ile Parametreleri Kullanma.

SelectCommand Veri kaynağı saklı yordamları destekliyorsa özelliği bir SQL dizesi veya saklı yordamın adı olabilir.

Ayrıca bkz.

Şunlara uygulanır