OleDbDataAdapter.SelectCommand Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define uma instrução SQL ou um procedimento armazenado usado para selecionar registros na fonte de dados.
public:
property System::Data::OleDb::OleDbCommand ^ SelectCommand { System::Data::OleDb::OleDbCommand ^ get(); void set(System::Data::OleDb::OleDbCommand ^ value); };
public System.Data.OleDb.OleDbCommand? SelectCommand { get; set; }
[System.Data.DataSysDescription("DbDataAdapter_SelectCommand")]
public System.Data.OleDb.OleDbCommand SelectCommand { get; set; }
public System.Data.OleDb.OleDbCommand SelectCommand { get; set; }
member this.SelectCommand : System.Data.OleDb.OleDbCommand with get, set
[<System.Data.DataSysDescription("DbDataAdapter_SelectCommand")>]
member this.SelectCommand : System.Data.OleDb.OleDbCommand with get, set
Public Property SelectCommand As OleDbCommand
Valor da propriedade
Um OleDbCommand que é usado durante o Fill(DataSet) para selecionar registros da fonte de dados para o posicionamento no DataSet.
- Atributos
Exemplos
O exemplo a seguir cria um OleDbDataAdapter e define as SelectCommand propriedades e InsertCommand . Ele pressupõe que você já tenha criado um OleDbConnection objeto .
public static OleDbDataAdapter CreateCustomerAdapter(
OleDbConnection connection)
{
OleDbDataAdapter adapter = new OleDbDataAdapter();
OleDbCommand command;
// Create the SelectCommand.
command = new OleDbCommand("SELECT * FROM Customers " +
"WHERE Country = ? AND City = ?", connection);
command.Parameters.Add("Country", OleDbType.VarChar, 15);
command.Parameters.Add("City", OleDbType.VarChar, 15);
adapter.SelectCommand = command;
// Create the InsertCommand.
command = new OleDbCommand(
"INSERT INTO Customers (CustomerID, CompanyName) " +
"VALUES (?, ?)", connection);
command.Parameters.Add(
"CustomerID", OleDbType.Char, 5, "CustomerID");
command.Parameters.Add(
"CompanyName", OleDbType.VarChar, 40, "CompanyName");
adapter.InsertCommand = command;
return adapter;
}
Public Shared Function CreateCustomerAdapter( _
connection As OleDbConnection) As OleDbDataAdapter
Dim adapter As New OleDbDataAdapter()
Dim command As OleDbCommand
' Create the SelectCommand.
command = New OleDbCommand("SELECT * FROM Customers " & _
"WHERE Country = ? AND City = ?", connection)
command.Parameters.Add("Country", OleDbType.VarChar, 15)
command.Parameters.Add("City", OleDbType.VarChar, 15)
adapter.SelectCommand = command
' Create the InsertCommand.
command = New OleDbCommand( _
"INSERT INTO Customers (CustomerID, CompanyName) " & _
"VALUES (?, ?)", connection)
command.Parameters.Add( _
"CustomerID", OleDbType.Char, 5, "CustomerID")
command.Parameters.Add( _
"CompanyName", OleDbType.VarChar, 40, "CompanyName")
adapter.InsertCommand = command
Return adapter
End Function
Comentários
Quando SelectCommand é atribuído a um criado OleDbCommandanteriormente, o OleDbCommand não é clonado. O SelectCommand mantém uma referência ao objeto criado OleDbCommand anteriormente.
Se o SelectCommand não retornar linhas, nenhuma tabela será adicionada ao DataSete nenhuma exceção será gerada.