Compartilhar via

SqlDataSource Construtores

Definição

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

Inicializa uma nova instância da classe SqlDataSource.

Sobrecargas

Nome Description
SqlDataSource()

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

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

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

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 SqlDataSource classe com a cadeia de conexão especificada e o comando Selecionar.

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 Parameter objetos à SelectParameters coleção.

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 empresarial 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 diferentes variedades de SQL, a sintaxe depende selectCommand do provedor de ADO.NET atual que está sendo usado, que é identificado pela ProviderName propriedade. Se a cadeia de caracteres SQL for uma consulta ou comando parametrizado, o espaço reservado do parâmetro também dependerá do provedor ADO.NET que está sendo usado. Por exemplo, se o provedor for o System.Data.SqlClientprovedor , 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 ou System.Data.Odbc o System.Data.OleDbespaço reservado do parâmetro for '?'. Para obter mais informações sobre consultas e comandos SQL parametrizados, consulte Como usar 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 SqlDataSource classe com a cadeia de conexão especificada e o comando Selecionar.

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 SqlDataSource . Se nenhum provedor estiver definido, o SqlDataSource provedor de 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 Parameter objetos à SelectParameters coleção.

Comentários

Como diferentes produtos de banco de dados usam diferentes variedades de SQL, a sintaxe depende selectCommand do provedor de ADO.NET atual que está sendo usado, que é identificado pelo providerName parâmetro. Se a cadeia de caracteres SQL for uma consulta ou comando parametrizado, o espaço reservado do parâmetro também dependerá do provedor ADO.NET que está 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 ou System.Data.Odbc o System.Data.OleDbespaço reservado do parâmetro for '?'. Para obter mais informações sobre consultas e comandos SQL parametrizados, consulte Como usar 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