Partilhar via


OleDbCommand.CommandText Propriedade

Definição

Obtém ou define a instrução SQL ou o procedimento armazenado a ser executado na fonte de dados.

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

Valor da propriedade

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

Implementações

Atributos

Exemplos

O exemplo a seguir cria um OleDbCommand e define algumas de 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

Comentários

Quando a CommandType propriedade é definida como StoredProcedure, a CommandType propriedade deve ser definida como o nome do procedimento armazenado. O usuário poderá ser obrigado a usar a sintaxe de caractere de escape se o nome do procedimento armazenado contiver caracteres especiais. O comando executa esse procedimento armazenado quando você chama um dos Execute métodos.

Quando CommandType é definido como TableDirect, a CommandType propriedade deve ser definida como o nome da tabela ou tabelas a serem acessadas. O usuário poderá ser obrigado a usar a sintaxe de caractere de escape se qualquer uma das tabelas nomeadas contiver caracteres especiais. Todas as linhas e colunas da tabela ou tabela nomeada serão retornadas quando você chamar um dos Execute métodos.

Você não poderá definir as Connectionpropriedades , CommandTypee CommandText se a conexão atual estiver executando uma operação de execução ou busca.

O Provedor de DB.NET OLE não dá suporte a parâmetros nomeados para passar parâmetros para uma instrução SQL ou um procedimento armazenado chamado por um OleDbCommand quando CommandType é definido Textcomo . Nesse caso, o espaço reservado do ponto de interrogação (?) deve ser usado. Por exemplo:

SELECT * FROM Customers WHERE CustomerID = ?

Portanto, a ordem na qual OleDbParameter os objetos são adicionados ao OleDbParameterCollection deve corresponder diretamente à posição do espaço reservado do ponto de interrogação para o parâmetro .

Para obter mais informações, consulte Configurando parâmetros e tipos de dados de parâmetro.

Aplica-se a

Confira também