OdbcCommand Classe

Definição

Espaço de Nomes:: System.Data.Odbc

Assemblagem:: System.Data.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Representa uma instrução SQL ou procedimento armazenado para executar contra uma fonte de dados. Esta classe não pode ser herdada.

public ref class OdbcCommand sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbCommand

public ref class OdbcCommand sealed : System::Data::Common::DbCommand, ICloneable

public sealed class OdbcCommand : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbCommand

public sealed class OdbcCommand : System.Data.Common.DbCommand, ICloneable

type OdbcCommand = class
    inherit Component
    interface ICloneable
    interface IDbCommand
    interface IDisposable

type OdbcCommand = class
    inherit DbCommand
    interface ICloneable

Public NotInheritable Class OdbcCommand
Inherits Component
Implements ICloneable, IDbCommand, IDisposable

Public NotInheritable Class OdbcCommand
Inherits DbCommand
Implements ICloneable

Herança: Object

MarshalByRefObject

Component
OdbcCommand

Herança: Object

MarshalByRefObject

Component

DbCommand
OdbcCommand

Implementações: IDbCommand ICloneable 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

Observações

A OdbcCommand classe fornece os seguintes métodos para executar comandos contra uma fonte de dados:

Número	Description
ExecuteReader	Executa comandos que devolvem linhas.
ExecuteNonQuery	Executa comandos como SQL INSERT, DELETE, UPDATE e instruções SET.
ExecuteScalar	Recupera um único valor, por exemplo, um valor agregado, de uma base de dados.

Podes repor a CommandText propriedade e reutilizar o OdbcCommand objeto. No entanto, deve fechar antes OdbcDataReader de poder executar um comando novo ou anterior.

Se a execução do comando causar um OdbcException fatal, como um nível de gravidade SQL Server de 20 ou mais, OdbcConnection pode fechar. No entanto, o utilizador pode reabrir a ligação e continuar.

Construtores

Name	Description
OdbcCommand()	Inicializa uma nova instância da OdbcCommand classe.
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

Name	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 para serem executados na fonte de dados.
CommandTimeout	Obtém ou define o tempo de espera (em segundos) antes de terminar 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 este DbCommand. (Herdado de DbCommand)
DbParameterCollection	Fica com a coleção de DbParameter objetos. (Herdado de DbCommand)
DbTransaction	Obtém ou define o DbTransaction dentro do qual este DbCommand objeto executa. (Herdado de DbCommand)
DesignMode	Obtém um valor que indica se o Component está atualmente em modo de design. (Herdado de Component)
DesignTimeVisible	Recebe ou define um valor que indica se o objeto de comando deve ser visível num controlo de interface personalizado.
Events	Obtém a lista de gestores de eventos que estão ligados a isto 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 OdbcTransaction dentro do qual executa OdbcCommand .
UpdatedRowSource	Recebe ou define um valor que especifica como o método Update deve aplicar os resultados do comando à DataRow.

Métodos

Name	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 toda a informação relevante necessária para gerar um proxy usado para comunicar com um objeto remoto. (Herdado de MarshalByRefObject)
CreateParameter()	Cria uma nova instância de um OdbcParameter objeto.
Dispose()	Liberta todos os recursos utilizados pelo Component. (Herdado de Component)
Dispose(Boolean)	Liberta os recursos não geridos usados pelo Component e opcionalmente liberta os recursos geridos. (Herdado de Component)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
ExecuteDbDataReader(CommandBehavior)	Executa o comando contra a sua ligação, devolvendo um DbDataReader que pode ser usado para aceder aos resultados. (Herdado de DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)	Os fornecedores devem implementar este 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 devolve uma tarefa concluída, bloqueando a thread que chama. A implementação por defeito devolverá uma tarefa cancelada se for recebida um token de cancelamento já cancelado. As exceções lançadas pelo ExecuteReader serão comunicadas através da propriedade de Exceção de Tarefa devolvida. Este método aceita um token de cancelamento que pode ser usado para pedir que a operação seja cancelada antecipadamente. As implementações podem ignorar este pedido. (Herdado de DbCommand)
ExecuteNonQuery()	Executa uma instrução SQL contra o Connection e devolve o número de linhas afetadas.
ExecuteNonQueryAsync()	Uma versão assíncrona de ExecuteNonQuery(), que executa o comando contra o seu objeto de ligação, devolvendo o número de linhas afetadas. Invoca ExecuteNonQueryAsync(CancellationToken) com CancellationToken.None. (Herdado de DbCommand)
ExecuteNonQueryAsync(CancellationToken)	Esta é a versão assíncrona de ExecuteNonQuery(). Os prestadores devem sobrepor-se com uma implementação adequada. O token de cancelamento pode, opcionalmente, ser ignorado. A implementação padrão invoca o método síncrono ExecuteNonQuery() e devolve uma tarefa concluída, bloqueando a thread que chama. A implementação por defeito devolverá uma tarefa cancelada se for recebida um token de cancelamento já cancelado. As exceções lançadas por ExecuteNonQuery() serão comunicadas através da propriedade de Exceção de Tarefa devolvida. Não invoque outros métodos e propriedades do `DbCommand` objeto até que a tarefa devolvida esteja concluída. (Herdado de DbCommand)
ExecuteReader()	Envia o CommandText para e Connection constrói um OdbcDataReader.
ExecuteReader(CommandBehavior)	Envia o CommandText para o Connection, e constrói um OdbcDataReader usando um dos `CommandBehavior` valores.
ExecuteReaderAsync()	Uma versão assíncrona de ExecuteReader, que executa o comando contra a sua ligação, retornando a DbDataReader que pode ser usada para aceder aos resultados. Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) com CancellationToken.None. (Herdado de DbCommand)
ExecuteReaderAsync(CancellationToken)	Uma versão assíncrona de ExecuteReader, que executa o comando contra a sua ligação, retornando a DbDataReader que pode ser usada para aceder aos resultados. Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Herdado de DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Herdado de DbCommand)
ExecuteReaderAsync(CommandBehavior)	Uma versão assíncrona de ExecuteReader, que executa o comando contra a sua ligação, retornando a DbDataReader que pode ser usada para aceder aos resultados. Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Herdado de DbCommand)
ExecuteScalar()	Executa a consulta e devolve a primeira coluna da primeira linha do conjunto de resultados devolvida pela consulta. Colunas ou linhas adicionais são ignoradas.
ExecuteScalarAsync()	Uma versão assíncrona de ExecuteScalar(), que executa o comando e devolve a primeira coluna da primeira linha do primeiro conjunto de resultados devolvido. Todas as outras colunas, linhas e conjuntos de resultados são ignorados. Invoca ExecuteScalarAsync(CancellationToken) com CancellationToken.None. (Herdado de DbCommand)
ExecuteScalarAsync(CancellationToken)	Esta é a versão assíncrona de ExecuteScalar(). Os prestadores devem sobrepor-se com uma implementação adequada. O token de cancelamento pode, opcionalmente, ser ignorado. A implementação padrão invoca o método síncrono ExecuteScalar() e devolve uma tarefa concluída, bloqueando a thread que chama. A implementação por defeito devolverá uma tarefa cancelada se for recebida um token de cancelamento já cancelado. As exceções lançadas pelo ExecuteScalar serão comunicadas através da propriedade de Exceção de Tarefa devolvida. Não invoque outros métodos e propriedades do `DbCommand` objeto até que a tarefa devolvida esteja concluída. (Herdado de DbCommand)
GetHashCode()	Serve como função de hash predefinida. (Herdado de Object)
GetLifetimeService()	Recupera o objeto de serviço de tempo de vida atual que controla a política de vida útil neste caso. (Herdado de MarshalByRefObject)
GetService(Type)	Devolve 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()	Obtém-se um objeto de serviço vitalício para controlar a apólice vitalícia neste caso. (Herdado de MarshalByRefObject)
MemberwiseClone()	Cria uma cópia superficial do atual Object. (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()	Reinicia a CommandTimeout propriedade para o valor padrão.
ToString()	Devolve a String contendo o nome do Component, se existir. Este método não deve ser ultrapassado. (Herdado de Component)

evento

Name	Description
Disposed	Ocorre quando o componente é eliminado por uma chamada ao Dispose() método. (Herdado de Component)

Implementações de Interface Explícita

Name	Description
ICloneable.Clone()	Para uma descrição deste elemento, veja 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 suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código. Executa o CommandText contra o Connection e constrói um IDataReader.
IDbCommand.ExecuteReader()	Executa o CommandText contra o Connection e constrói um IDataReader. (Herdado de DbCommand)
IDbCommand.ExecuteReader(CommandBehavior)	Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código. Executa o CommandText contra o Connection, e constrói um IDataReader usando o comportamento especificado.
IDbCommand.ExecuteReader(CommandBehavior)	Executa o CommandText contra o Connection, e constrói um IDataReader usando um dos CommandBehavior valores. (Herdado de DbCommand)
IDbCommand.Parameters	Obtém o IDataParameterCollection. (Herdado de DbCommand)
IDbCommand.Transaction	Obtém ou define o DbTransaction dentro do qual este DbCommand objeto executa. (Herdado de DbCommand)

Aplica-se a

Ver também

Comentários

Esta página foi útil?