SqlDataSource Construtores

public:
 SqlDataSource();

public SqlDataSource();

Public Sub New ()

Ver também

• SqlDataSourceView
• AccessDataSource
• DataSourceControl
• Controlo do Servidor Web de Fonte de Dados
• Visão geral do Controlo de Servidores Web do SqlDataSource

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)

Parâmetros

Exemplos

O exemplo de código seguinte demonstra como criar um SqlDataSource controlo usando o SqlDataSource construtor. O exemplo é invulgar porque o SqlDataSource controlo está a ser usado não numa página Web Forms, mas na implementação de um objeto de nível intermédio como uma forma simples de um objeto de negócio interagir com uma base de dados. O exemplo utiliza um cadeia de ligação que é armazenado no ficheiro Web.config.

Este exemplo de código faz parte de um exemplo maior fornecido para a ObjectDataSource classe.

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

Observações

Como diferentes produtos de bases de dados usam diferentes variedades de SQL, a sintaxe para selectCommand depende do fornecedor atual .NET ADO utilizado, que é identificado pela propriedade ProviderName. Se a string SQL for uma consulta ou comando parametrizado, o marcador de posição do parâmetro também depende do fornecedor ADO.NET que está a ser utilizado. Por exemplo, se o fornecedor for o System.Data.SqlClient, que é o fornecedor padrão para a SqlDataSource classe, o marcador de posição do parâmetro é '@parameterName'. No entanto, se o fornecedor estiver definido como o System.Data.Odbc ou o System.Data.OleDb, o marcador de lugar do parâmetro é '?'. Para mais informações sobre consultas e comandos SQL parametrizados, consulte Utilização de Parâmetros com o Controlo SqlDataSource.

O SelectCommand valor pode ser uma string SQL ou o nome de um procedimento armazenado, se a fonte de dados suportar procedimentos armazenados.

Ver também

• ConnectionString
• SelectCommand
• SelectParameters
• Controlo do Servidor Web de Fonte de Dados
• Visão geral do Controlo de Servidores Web do SqlDataSource

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)

Parâmetros

Observações

Como diferentes produtos de bases de dados usam diferentes variedades de SQL, a sintaxe de selectCommand depende do fornecedor atual de ADO.NET utilizado, que é identificado pelo parâmetro providerName. Se a string SQL for uma consulta ou comando parametrizado, o marcador de posição do parâmetro também depende do fornecedor ADO.NET que está a ser utilizado. Por exemplo, se o fornecedor for System.Data.SqlClient, que é o fornecedor padrão para a SqlDataSource classe, o marcador de posição do parâmetro é '@parameterName'. No entanto, se o fornecedor estiver definido como o System.Data.Odbc ou o System.Data.OleDb, o marcador de lugar do parâmetro é '?'. Para mais informações sobre consultas e comandos SQL parametrizados, consulte Utilização de Parâmetros com o Controlo SqlDataSource.

A SelectCommand propriedade pode ser uma string SQL ou o nome de um procedimento armazenado, se a fonte de dados suportar procedimentos armazenados.

Ver também

• ProviderName
• ConnectionString
• SelectCommand
• SelectParameters
• Controlo do Servidor Web de Fonte de Dados
• Visão geral do Controlo de Servidores Web do SqlDataSource