OleDbCommand.CommandText Propriedade

Definição

Espaço de Nomes:
System.Data.OleDb
Assemblagem:
System.Data.dll

Obtém ou define a instrução SQL ou o procedimento armazenado para serem executados na fonte de dados.

public:
 property System::String ^ CommandText { System::String ^ get(); void set(System::String ^ value); };
public:
 virtual property System::String ^ CommandText { System::String ^ get(); void set(System::String ^ value); };
[System.Data.DataSysDescription("DbCommand_CommandText")]
public string CommandText { get; set; }
public override string CommandText { get; set; }
[<System.Data.DataSysDescription("DbCommand_CommandText")>]
member this.CommandText : string with get, set
member this.CommandText : string with get, set
Public Property CommandText As String
Public Overrides Property CommandText As String

Valor de Propriedade

String

A instrução SQL ou procedimento armazenado a executar. O valor padrão é uma cadeia de caracteres vazia.

Implementações

CommandText
Atributos
DataSysDescriptionAttribute

Exemplos

O exemplo seguinte cria um OleDbCommand e define algumas das suas propriedades.

public void CreateMyOleDbCommand()
{
   OleDbCommand command = new OleDbCommand();
   command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID";
   command.CommandTimeout = 20;
}

Public Sub CreateMyOleDbCommand()
    Dim command As New OleDbCommand()
    command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID"
    command.CommandTimeout = 20
End Sub

Observações

Quando a CommandType propriedade é definida para StoredProcedure, deve ser CommandType definida como o nome do procedimento armazenado. O utilizador pode ser obrigado a usar a sintaxe do carácter escape se o nome do procedimento armazenado contiver caracteres especiais. O comando executa este procedimento armazenado quando chamas um dos Execute métodos.

Quando CommandType está definido como TableDirect, a CommandType propriedade deve ser definida como o nome da tabela ou tabelas a serem acedidas. O utilizador pode ser obrigado a usar a sintaxe dos caracteres escape se alguma das tabelas nomeadas contiver caracteres especiais. Todas as linhas e colunas da tabela ou tabelas nomeadas serão devolvidas quando chamar um dos Execute métodos.

Não pode definir as Connectionpropriedades , CommandType, e CommandText se a ligação atual estiver a executar ou buscar uma operação.

O OLE DB.NET Provider não suporta parâmetros nomeados para passar parâmetros a uma Instrução SQL ou a um procedimento armazenado chamado por um OleDbCommand quando CommandType está definido para Text. Neste caso, deve ser usado o marcador de interrogação (?). Por exemplo:

SELECT * FROM Customers WHERE CustomerID = ?

Portanto, a ordem em que OleDbParameter os objetos são adicionados OleDbParameterCollection ao deve corresponder diretamente à posição do marcador de interrogação para o parâmetro.

Para mais informações, consulte Configuração de Parâmetros e Tipos de Dados de Parâmetros.

Aplica-se a

Ver também