OdbcCommand Classe
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.
Representa uma instrução SQL ou procedimento armazenado a executar contra uma fonte de dados. Essa classe não pode ser herdada.
public ref class OdbcCommand sealed : System::Data::Common::DbCommand, ICloneable
public ref class OdbcCommand sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbCommand
public sealed class OdbcCommand : System.Data.Common.DbCommand, ICloneable
public sealed class OdbcCommand : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbCommand
type OdbcCommand = class
inherit DbCommand
interface ICloneable
type OdbcCommand = class
inherit Component
interface ICloneable
interface IDbCommand
interface IDisposable
Public NotInheritable Class OdbcCommand
Inherits DbCommand
Implements ICloneable
Public NotInheritable Class OdbcCommand
Inherits Component
Implements ICloneable, IDbCommand, IDisposable
- Herança
- Herança
- Implementações
Exemplos
O exemplo a seguir usa ExecuteNonQuery.
public void InsertRow(string connectionString, string insertSQL)
{
using (OdbcConnection connection =
new OdbcConnection(connectionString))
{
// The insertSQL string contains a SQL statement that
// inserts a new row in the source table.
OdbcCommand command = new OdbcCommand(insertSQL, connection);
// Open the connection and execute the insert command.
try
{
connection.Open();
command.ExecuteNonQuery();
}
catch (Exception ex)
{
Console.WriteLine(ex.Message);
}
// The connection is automatically closed when the
// code exits the using block.
}
Public Sub InsertRow(ByVal connectionString As String, _
ByVal insertSQL As String)
Using connection As New OdbcConnection(connectionString)
' The insertSQL string contains a SQL statement that
' inserts a new row in the source table.
Dim command As New OdbcCommand(insertSQL, connection)
' Open the connection and execute the insert command.
Try
connection.Open()
command.ExecuteNonQuery()
Catch ex As Exception
Console.WriteLine(ex.Message)
End Try
' The connection is automatically closed when the
' code exits the Using block.
End Using
End Sub
Comentários
A OdbcCommand classe fornece os seguintes métodos para executar comandos em uma fonte de dados:
Item | Descrição |
---|---|
ExecuteReader | Executa comandos que retornam linhas. |
ExecuteNonQuery | Executa comandos como instruções SQL INSERT, DELETE, UPDATE e SET. |
ExecuteScalar | Recupera um único valor, por exemplo, um valor agregado, de um banco de dados. |
Você pode redefinir a CommandText propriedade e reutilizar o OdbcCommand objeto. No entanto, você deve fechar o OdbcDataReader antes de executar um comando novo ou anterior.
Se a execução do comando causar um fatalOdbcException, como um nível de gravidade SQL Server de 20 ou mais, OdbcConnection poderá ser fechado. No entanto, o usuário pode reabrir a conexão e continuar.
Construtores
OdbcCommand() |
Inicializa uma nova instância da classe OdbcCommand. |
OdbcCommand(String) |
Inicializa uma nova instância da classe OdbcCommand com o texto da consulta. |
OdbcCommand(String, OdbcConnection) |
Inicializa uma nova instância da classe OdbcCommand com o texto da consulta e um objeto OdbcConnection. |
OdbcCommand(String, OdbcConnection, OdbcTransaction) |
Inicializa uma nova instância da classe OdbcCommand com o texto da consulta, um objeto OdbcConnection e o Transaction. |
Propriedades
CanRaiseEvents |
Obtém um valor que indica se o componente pode acionar um evento. (Herdado de Component) |
CommandText |
Obtém ou define a instrução SQL ou o procedimento armazenado a ser executado em relação à fonte de dados. |
CommandTimeout |
Obtém ou define o tempo de espera (em segundos) antes de encerrar uma tentativa de executar um comando e antes de gerar um erro. |
CommandType |
Obtém ou define um valor que indica como a propriedade CommandText é interpretada. |
Connection |
Obtém ou define o OdbcConnection usado por essa instância do OdbcCommand. |
Container |
Obtém o IContainer que contém o Component. (Herdado de Component) |
DbConnection |
Obtém ou define o DbConnection usado pelo DbCommand. (Herdado de DbCommand) |
DbParameterCollection |
Obtém a coleção de objetos DbParameter. (Herdado de DbCommand) |
DbTransaction |
Obtém ou define o DbCommand em que este objeto DbTransaction é executado. (Herdado de DbCommand) |
DesignMode |
Obtém um valor que indica se o Component está no modo de design no momento. (Herdado de Component) |
DesignTimeVisible |
Obtém ou define um valor que indica se o objeto de comando deve estar visível em um controle da interface personalizada. |
Events |
Obtém a lista de manipuladores de eventos que estão anexados a este Component. (Herdado de Component) |
Parameters |
Obtém o OdbcParameterCollection. |
Site |
Obtém ou define o ISite do Component. (Herdado de Component) |
Transaction |
Obtém ou define o OdbcCommand em que o OdbcTransaction é executado. |
UpdatedRowSource |
Obtém ou define um valor que especifica como o método Update deve aplicar os resultados do comando para o DataRow. |
Métodos
Cancel() |
Tenta cancelar a execução de um OdbcCommand. |
CreateDbParameter() |
Cria uma nova instância de um objeto DbParameter. (Herdado de DbCommand) |
CreateObjRef(Type) |
Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto. (Herdado de MarshalByRefObject) |
CreateParameter() |
Cria uma nova instância de um objeto OdbcParameter. |
Dispose() |
Realiza tarefas definidas pelo aplicativo associadas à liberação ou à redefinição de recursos não gerenciados. (Herdado de DbCommand) |
Dispose() |
Libera todos os recursos usados pelo Component. (Herdado de Component) |
Dispose(Boolean) |
Libera os recursos não gerenciados usados pelo DbCommand e opcionalmente libera os recursos gerenciados. (Herdado de DbCommand) |
Dispose(Boolean) |
Libera os recursos não gerenciados usados pelo Component e opcionalmente libera os recursos gerenciados. (Herdado de Component) |
DisposeAsync() |
Descarta de forma assíncrona o objeto de comando. (Herdado de DbCommand) |
Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
ExecuteDbDataReader(CommandBehavior) |
Executa o comando em relação à sua conexão, retornando um DbDataReader que pode ser usado para acessar os resultados. (Herdado de DbCommand) |
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) |
Os provedores devem implementar esse método para fornecer uma implementação não padrão para sobrecargas ExecuteReader. A implementação padrão invoca o método ExecuteReader() síncrono e retorna uma tarefa concluída, bloqueando o thread de chamada. A implementação padrão retornará uma tarefa cancelada se já tiver passado um token de cancelamento. Exceções geradas por ExecuteReader serão comunicadas por meio da propriedade Exceção de Tarefa retornada. Esse método aceita um token de cancelamento que pode ser usado para solicitar a operação a ser cancelada no início. As implementações podem ignorar essa solicitação. (Herdado de DbCommand) |
ExecuteNonQuery() |
Executa uma instrução SQL no Connection e retorna o número de linhas afetadas. |
ExecuteNonQueryAsync() |
Uma versão assíncrona do ExecuteNonQuery(), que executa o comando em seu objeto de conexão, retornando o número de linhas afetadas. Invoca ExecuteNonQueryAsync(CancellationToken) com CancellationToken.None. (Herdado de DbCommand) |
ExecuteNonQueryAsync(CancellationToken) |
Essa é a versão assíncrona de ExecuteNonQuery(). Provedores devem substituir com uma implementação apropriada. Opcionalmente, o token de cancelamento pode ser ignorado. A implementação padrão invoca o método ExecuteNonQuery() síncrono e retorna uma tarefa concluída, bloqueando o thread de chamada. A implementação padrão retornará uma tarefa cancelada se já tiver passado um token de cancelamento. Exceções geradas por ExecuteNonQuery() serão comunicadas por meio da propriedade Exceção de Tarefa retornada. Não invoque outros métodos e propriedades do objeto |
ExecuteReader() |
Envia o CommandText para o Connection e cria um OdbcDataReader. |
ExecuteReader(CommandBehavior) |
Envia o CommandText para o Connection e cria um OdbcDataReader usando um dos valores |
ExecuteReaderAsync() |
Uma versão assíncrona do ExecuteReader, que executa o comando em sua conexão, retornando um DbDataReader que pode ser usado para acessar os resultados. Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) com CancellationToken.None. (Herdado de DbCommand) |
ExecuteReaderAsync(CancellationToken) |
Uma versão assíncrona do ExecuteReader, que executa o comando em sua conexão, retornando um DbDataReader que pode ser usado para acessar os resultados. Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Herdado de DbCommand) |
ExecuteReaderAsync(CommandBehavior) |
Uma versão assíncrona do ExecuteReader, que executa o comando em sua conexão, retornando um DbDataReader que pode ser usado para acessar os resultados. Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Herdado de DbCommand) |
ExecuteReaderAsync(CommandBehavior, CancellationToken) |
Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Herdado de DbCommand) |
ExecuteScalar() |
Executa a consulta e retorna a primeira coluna da primeira linha no conjunto de resultados retornado pela consulta. Colunas ou linhas adicionais são ignoradas. |
ExecuteScalarAsync() |
Uma versão assíncrona do ExecuteScalar(), que executa o comando e retorna a primeira coluna da primeira linha no primeiro conjunto de resultados retornado. Todas as outras colunas, linhas e conjuntos de resultados são ignorados. Invoca ExecuteScalarAsync(CancellationToken) com CancellationToken.None. (Herdado de DbCommand) |
ExecuteScalarAsync(CancellationToken) |
Essa é a versão assíncrona de ExecuteScalar(). Provedores devem substituir com uma implementação apropriada. Opcionalmente, o token de cancelamento pode ser ignorado. A implementação padrão invoca o método ExecuteScalar() síncrono e retorna uma tarefa concluída, bloqueando o thread de chamada. A implementação padrão retornará uma tarefa cancelada se já tiver passado um token de cancelamento. Exceções geradas por ExecuteScalar serão comunicadas por meio da propriedade Exceção de Tarefa retornada. Não invoque outros métodos e propriedades do objeto |
GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
GetLifetimeService() |
Obsoleto.
Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância. (Herdado de MarshalByRefObject) |
GetService(Type) |
Retorna um objeto que representa um serviço fornecido pelo Component ou pelo seu Container. (Herdado de Component) |
GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
InitializeLifetimeService() |
Obsoleto.
Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject) |
MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
MemberwiseClone(Boolean) |
Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject) |
Prepare() |
Cria uma versão preparada ou compilada do comando na fonte de dados. |
PrepareAsync(CancellationToken) |
Cria de maneira assíncrona uma versão preparada (ou compilada) do comando na fonte de dados. (Herdado de DbCommand) |
ResetCommandTimeout() |
Redefine a propriedade CommandTimeout para o valor padrão. |
ToString() |
Retorna um String que contém o nome do Component, se houver. Esse método não deve ser substituído. (Herdado de Component) |
Eventos
Disposed |
Ocorre quando o componente é disposto por uma chamada ao método Dispose(). (Herdado de Component) |
Implantações explícitas de interface
ICloneable.Clone() |
Para obter uma descrição desse membro, confira Clone(). |
IDbCommand.Connection |
Obtém ou define o IDbConnection usado por essa instância do IDbCommand. (Herdado de DbCommand) |
IDbCommand.CreateParameter() |
Cria uma nova instância de um objeto IDbDataParameter. |
IDbCommand.CreateParameter() |
Cria uma nova instância de um objeto IDbDataParameter. (Herdado de DbCommand) |
IDbCommand.ExecuteReader() |
Esta API dá suporte à infraestrutura do produto e não deve ser usada diretamente do seu código. Executa o CommandText no Connection e compila um IDataReader. |
IDbCommand.ExecuteReader() |
Executa o CommandText no Connection e compila um IDataReader. (Herdado de DbCommand) |
IDbCommand.ExecuteReader(CommandBehavior) |
Esta API dá suporte à infraestrutura do produto e não deve ser usada diretamente do seu código. Executa o CommandText na Connection e cria um IDataReader usando o comportamento especificado. |
IDbCommand.ExecuteReader(CommandBehavior) |
Executa o CommandText para o Connection e cria um IDataReader usando um dos valores de CommandBehavior. (Herdado de DbCommand) |
IDbCommand.Parameters |
Obtém o IDataParameterCollection. (Herdado de DbCommand) |
IDbCommand.Transaction |
Obtém ou define o DbCommand em que este objeto DbTransaction é executado. (Herdado de DbCommand) |
Métodos de Extensão
ConfigureAwait(IAsyncDisposable, Boolean) |
Configura como as esperas nas tarefas retornadas de um descartável assíncrono são realizadas. |
Aplica-se a
Confira também
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários