Compartilhar via

SqlDataSource Construtores

  • Referência

Definição

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Inicializa uma nova instância da classe SqlDataSource.

Sobrecargas

SqlDataSource()

Inicializa uma nova instância da classe SqlDataSource.
SqlDataSource(String, String)

Inicializa uma nova instância da classe SqlDataSource com a cadeia de conexão especificada e o comando Select.
SqlDataSource(String, String, String)

Inicializa uma nova instância da classe SqlDataSource com a cadeia de conexão especificada e o comando Select.

SqlDataSource()

Inicializa uma nova instância da classe SqlDataSource.

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

Confira também

Aplica-se a

SqlDataSource(String, String)

Inicializa uma nova instância da classe SqlDataSource com a cadeia de conexão especificada e o comando 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)

Parâmetros

connectionString
String

A cadeia de conexão usada para se conectar ao banco de dados subjacente.

selectCommand
String

A consulta SQL usada para recuperar dados do banco de dados subjacente. Se a consulta SQL for uma cadeia de caracteres SQL parametrizada, talvez seja necessário adicionar objetos Parameter à coleção SelectParameters.

Exemplos

O exemplo de código a seguir demonstra como criar um SqlDataSource controle usando o SqlDataSource construtor . O exemplo é incomum porque o SqlDataSource controle está sendo usado não em uma página do Web Forms, mas na implementação de um objeto de camada intermediária como uma maneira simples de um objeto de negócios interagir com um banco de dados. O exemplo usa uma cadeia de conexão armazenada no arquivo 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

Comentários

Como diferentes produtos de banco de dados usam variedades diferentes de SQL, a sintaxe para selectCommand depende do provedor de ADO.NET atual que está sendo usado, que é identificado pela ProviderName propriedade . Se a cadeia de caracteres SQL é uma consulta ou comando parametrizado, o espaço reservado de parâmetro também depende do provedor ADO.NET sendo usado. Por exemplo, se o provedor for o System.Data.SqlClient, que é o provedor padrão para a SqlDataSource classe , o espaço reservado do parâmetro será '@parameterName'. No entanto, se o provedor estiver definido como System.Data.Odbc ou , System.Data.OleDbo espaço reservado do parâmetro será '?'. Para obter mais informações sobre consultas e comandos SQL parametrizados, consulte Usando parâmetros com o controle SqlDataSource.

O SelectCommand valor pode ser uma cadeia de caracteres SQL ou o nome de um procedimento armazenado, se a fonte de dados der suporte a procedimentos armazenados.

Confira também

Aplica-se a

SqlDataSource(String, String, String)

Inicializa uma nova instância da classe SqlDataSource com a cadeia de conexão especificada e o comando 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)

Parâmetros

providerName
String

O nome do provedor de dados usado pelo SqlDataSource. Se nenhum provedor é definido, o SqlDataSource usa o provedor ADO.NET para o Microsoft SQL Server, por padrão.

connectionString
String

A cadeia de conexão usada para se conectar ao banco de dados subjacente.

selectCommand
String

A consulta SQL usada para recuperar dados do banco de dados subjacente. Se a consulta SQL for uma cadeia de caracteres SQL parametrizada, talvez seja necessário adicionar objetos Parameter à coleção SelectParameters.

Comentários

Como diferentes produtos de banco de dados usam diferentes variedades de SQL, a sintaxe de selectCommand depende do provedor de ADO.NET atual que está sendo usado, que é identificado pelo providerName parâmetro . Se a cadeia de caracteres SQL é uma consulta ou comando parametrizado, o espaço reservado de parâmetro também depende do provedor ADO.NET sendo usado. Por exemplo, se o provedor for System.Data.SqlClient, que é o provedor padrão para a SqlDataSource classe , o espaço reservado do parâmetro será '@parameterName'. No entanto, se o provedor estiver definido como System.Data.Odbc ou , System.Data.OleDbo espaço reservado do parâmetro será '?'. Para obter mais informações sobre consultas e comandos SQL parametrizados, consulte Usando parâmetros com o controle SqlDataSource.

A SelectCommand propriedade pode ser uma cadeia de caracteres SQL ou o nome de um procedimento armazenado, se a fonte de dados der suporte a procedimentos armazenados.

Confira também

Aplica-se a