OdbcCommand Classe

Definição

Namespace:: System.Data.Odbc

Assembly:: System.Data.Odbc.dll

Assembly:: System.Data.dll

Pacote:: System.Data.Odbc v11.0.0-preview.2.26159.112

Origem:: OdbcCommand.cs

Origem:: OdbcCommand.cs

Origem:: OdbcCommand.cs

Origem:: OdbcCommand.cs

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 um procedimento armazenado a ser executado em 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: Object

DbCommand
OdbcCommand

Herança: Object

MarshalByRefObject

Component

DbCommand
OdbcCommand

Herança: Object

MarshalByRefObject

Component
OdbcCommand

Implementações: ICloneable IDbCommand IDisposable

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 antes OdbcDataReader de executar um comando novo ou anterior.

Se a execução do comando causar um fatal OdbcException , como um nível de severidade do SQL Server de 20 ou mais, OdbcConnection poderá ser fechado. No entanto, o usuário pode reabrir a conexão e continuar.

Construtores

Nome	Description
OdbcCommand()	Inicializa uma nova instância da classe OdbcCommand.
OdbcCommand(String, OdbcConnection, OdbcTransaction)	Inicializa uma nova instância da OdbcCommand classe com o texto da consulta, um OdbcConnection objeto e o Transaction.
OdbcCommand(String, OdbcConnection)	Inicializa uma nova instância da OdbcCommand classe com o texto da consulta e um OdbcConnection objeto.
OdbcCommand(String)	Inicializa uma nova instância da OdbcCommand classe com o texto da consulta.

Propriedades

Nome	Description
CanRaiseEvents	Obtém um valor que indica se o componente pode gerar um evento. (Herdado de Component)
CommandText	Obtém ou define a instrução SQL ou o procedimento armazenado a ser executado na fonte de dados.
CommandTimeout	Obtém ou define o tempo de espera (em segundos) antes de encerrar uma tentativa de executar um comando e gerar um erro.
CommandType	Obtém ou define um valor que indica como a CommandText propriedade é interpretada.
Connection	Obtém ou define o OdbcConnection usado por esta 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 por isso DbCommand. (Herdado de DbCommand)
DbParameterCollection	Obtém a coleção de DbParameter objetos. (Herdado de DbCommand)
DbTransaction	Obtém ou define o DbTransaction interior no qual este DbCommand objeto é 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 de interface personalizado.
Events	Obtém a lista de manipuladores de eventos anexados a isso Component. (Herdado de Component)
Parameters	Obtém OdbcParameterCollection.
Site	Obtém ou define o ISite Component. (Herdado de Component)
Transaction	Obtém ou define o OdbcTransaction interior no qual a OdbcCommand execução é executada.
UpdatedRowSource	Obtém ou define um valor que especifica como o método Update deve aplicar resultados de comando ao DataRow.

Métodos

Nome	Description
Cancel()	Tenta cancelar a execução de um OdbcCommand.
CreateDbParameter()	Cria uma nova instância de um DbParameter objeto. (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 OdbcParameter objeto.
Dispose()	Libera todos os recursos usados pelo Component. (Herdado de Component)
Dispose(Boolean)	Libera os recursos não gerenciados usados pelo Component e, opcionalmente, libera os recursos gerenciados. (Herdado de Component)
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 ExecuteReader sobrecargas. A implementação padrão invoca o método síncrono ExecuteReader() e retorna uma tarefa concluída, bloqueando o thread de chamada. A implementação padrão retornará uma tarefa cancelada se passar um token de cancelamento já cancelado. As exceções geradas pelo ExecuteReader serão comunicadas por meio da propriedade de Exceção de Tarefa retornada. Esse método aceita um token de cancelamento que pode ser usado para solicitar que a operação seja cancelada antecipadamente. As implementações podem ignorar essa solicitação. (Herdado de DbCommand)
ExecuteNonQuery()	Executa uma instrução Connection SQL e retorna o número de linhas afetadas.
ExecuteNonQueryAsync()	Uma versão assíncrona de ExecuteNonQuery(), que executa o comando em seu objeto de conexão, retornando o número de linhas afetadas. ExecuteNonQueryAsync(CancellationToken) Invoca com CancellationToken.None. (Herdado de DbCommand)
ExecuteNonQueryAsync(CancellationToken)	Esta é a versão assíncrona de ExecuteNonQuery(). Os 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 síncrono ExecuteNonQuery() e retorna uma tarefa concluída, bloqueando o thread de chamada. A implementação padrão retornará uma tarefa cancelada se passar um token de cancelamento já cancelado. As exceções geradas serão comunicadas por ExecuteNonQuery() meio da propriedade de Exceção de Tarefa retornada. Não invoque outros métodos e propriedades do `DbCommand` objeto até que a Tarefa retornada seja concluída. (Herdado de DbCommand)
ExecuteReader()	Envia o CommandText para o Connection e cria um OdbcDataReader.
ExecuteReader(CommandBehavior)	Envia o CommandText para o Connectione cria um OdbcDataReader usando um dos `CommandBehavior` valores.
ExecuteReaderAsync()	Uma versão assíncrona de ExecuteReader, que executa o comando em relação à sua conexão, retornando uma DbDataReader que pode ser usada para acessar os resultados. ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) Invoca com CancellationToken.None. (Herdado de DbCommand)
ExecuteReaderAsync(CancellationToken)	Uma versão assíncrona de ExecuteReader, que executa o comando em relação à sua conexão, retornando uma DbDataReader que pode ser usada para acessar os resultados. ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Invoca . (Herdado de DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)	ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Invoca . (Herdado de DbCommand)
ExecuteReaderAsync(CommandBehavior)	Uma versão assíncrona de ExecuteReader, que executa o comando em relação à sua conexão, retornando uma DbDataReader que pode ser usada para acessar os resultados. ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Invoca . (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 de 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. ExecuteScalarAsync(CancellationToken) Invoca com CancellationToken.None. (Herdado de DbCommand)
ExecuteScalarAsync(CancellationToken)	Esta é a versão assíncrona de ExecuteScalar(). Os 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 síncrono ExecuteScalar() e retorna uma tarefa concluída, bloqueando o thread de chamada. A implementação padrão retornará uma tarefa cancelada se passar um token de cancelamento já cancelado. As exceções geradas pelo ExecuteScalar serão comunicadas por meio da propriedade de Exceção de Tarefa retornada. Não invoque outros métodos e propriedades do `DbCommand` objeto até que a Tarefa retornada seja concluída. (Herdado de DbCommand)
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 tempo de vida para essa instância. (Herdado de MarshalByRefObject)
GetService(Type)	Retorna um objeto que representa um serviço fornecido pelo Component ou por sua 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 dessa instância. (Herdado de MarshalByRefObject)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto atual MarshalByRefObject . (Herdado de MarshalByRefObject)
Prepare()	Cria uma versão preparada ou compilada do comando na fonte de dados.
ResetCommandTimeout()	Redefine a CommandTimeout propriedade 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

Nome	Description
Disposed	Ocorre quando o componente é descartado por uma chamada para o Dispose() método. (Herdado de Component)

Implantações explícitas de interface

Nome	Description
ICloneable.Clone()	Para obter uma descrição deste membro, consulte Clone().
IDbCommand.Connection	Obtém ou define o IDbConnection usado por esta instância do IDbCommand. (Herdado de DbCommand)
IDbCommand.CreateParameter()	Cria uma nova instância de um IDbDataParameter objeto.
IDbCommand.CreateParameter()	Cria uma nova instância de um IDbDataParameter objeto. (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 contra e Connection cria um IDataReader.
IDbCommand.ExecuteReader()	Executa o CommandText contra e Connection cria 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 contra e Connectioncria um IDataReader usando o comportamento especificado.
IDbCommand.ExecuteReader(CommandBehavior)	Executa o CommandText contra e Connectioncria um usando um IDataReader dos CommandBehavior valores. (Herdado de DbCommand)
IDbCommand.Parameters	Obtém IDataParameterCollection. (Herdado de DbCommand)
IDbCommand.Transaction	Obtém ou define o DbTransaction interior no qual este DbCommand objeto é executado. (Herdado de DbCommand)

Aplica-se a

Confira também

Comentários

Esta página foi útil?

Partilhar via

OdbcCommand Classe

Definição

Exemplos

Comentários

Construtores

Propriedades

Métodos

Eventos

Implantações explícitas de interface

Aplica-se a

Confira também

Comentários