OdbcCommand Třída

Definice

Obor názvů:

System.Data.Odbc

Sestavení:

System.Data.Odbc.dll

Balíček:

System.Data.Odbc v9.0.0-rc.1.24431.7

Zdroj:

OdbcCommand.cs

Představuje příkaz SQL nebo uloženou proceduru, která se má provést ve zdroji dat. Tuto třídu nelze zdědit.

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

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

type OdbcCommand = class
    inherit DbCommand
    interface ICloneable

Public NotInheritable Class OdbcCommand
Inherits DbCommand
Implements ICloneable

Dědičnost

Object

MarshalByRefObject

Component

DbCommand

OdbcCommand

Implementuje

ICloneable

Příklady

Následující příklad používá 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

Poznámky

Třída OdbcCommand poskytuje následující metody pro spouštění příkazů ve zdroji dat:

Položka	Popis
ExecuteReader	Spustí příkazy, které vracejí řádky.
ExecuteNonQuery	Spouští příkazy, jako jsou příkazy SQL INSERT, DELETE, UPDATE a SET.
ExecuteScalar	Načte z databáze jednu hodnotu, například agregační hodnotu.

Vlastnost CommandText můžete obnovit a znovu použít objekt OdbcCommand. Před spuštěním nového nebo předchozího příkazu však musíte OdbcDataReader zavřít.

Pokud spuštění příkazu způsobí závažnou OdbcException, jako je například úroveň závažnosti SQL Serveru 20 nebo více, může OdbcConnection zavřít. Uživatel ale může znovu otevřít připojení a pokračovat.

Konstruktory

OdbcCommand()	Inicializuje novou instanci OdbcCommand třídy.
OdbcCommand(String)	Inicializuje novou instanci třídy OdbcCommand textem dotazu.
OdbcCommand(String, OdbcConnection)	Inicializuje novou instanci třídy OdbcCommand s textem dotazu a objektem OdbcConnection.
OdbcCommand(String, OdbcConnection, OdbcTransaction)	Inicializuje novou instanci třídy OdbcCommand s textem dotazu, objektem OdbcConnection a Transaction.

Vlastnosti

CanRaiseEvents	Získá hodnotu určující, zda komponenta může vyvolat událost. (Zděděno od Component)
CommandText	Získá nebo nastaví příkaz SQL nebo uloženou proceduru pro spuštění proti zdroji dat.
CommandTimeout	Získá nebo nastaví dobu čekání (v sekundách) před ukončením pokusu o spuštění příkazu a generování chyby.
CommandType	Získá nebo nastaví hodnotu, která určuje, jak CommandText vlastnost je interpretována.
Connection	Získá nebo nastaví OdbcConnection používané touto instancí OdbcCommand.
Container	Získá IContainer, který obsahuje Component. (Zděděno od Component)
DbConnection	Získá nebo nastaví DbConnection používané tímto DbCommand. (Zděděno od DbCommand)
DbParameterCollection	Získá kolekci DbParameter objektů. (Zděděno od DbCommand)
DbTransaction	Získá nebo nastaví DbTransaction, ve kterém se tento DbCommand objekt spustí. (Zděděno od DbCommand)
DesignMode	Získá hodnotu, která označuje, zda Component je aktuálně v režimu návrhu. (Zděděno od Component)
DesignTimeVisible	Získá nebo nastaví hodnotu, která určuje, zda příkazový objekt by měl být viditelný v přizpůsobeném rozhraní ovládacího prvku.
Events	Získá seznam obslužných rutin událostí, které jsou připojeny k tomuto Component. (Zděděno od Component)
Parameters	Získá OdbcParameterCollection.
Site	Získá nebo nastaví ISiteComponent. (Zděděno od Component)
Transaction	Získá nebo nastaví OdbcTransaction, ve kterém se OdbcCommand spustí.
UpdatedRowSource	Získá nebo nastaví hodnotu, která určuje, jak Update metoda použít výsledky příkazu na DataRow.

Metody

Cancel()	Pokusí se zrušit provádění OdbcCommand.
CreateDbParameter()	Vytvoří novou instanci objektu DbParameter. (Zděděno od DbCommand)
CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy serveru sloužícího ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
CreateParameter()	Vytvoří novou instanci objektu OdbcParameter.
Dispose()	Provádí úlohy definované aplikací související s uvolněním, uvolněním nebo resetováním nespravovaných prostředků. (Zděděno od DbCommand)
Dispose(Boolean)	Uvolní nespravované prostředky používané DbCommand a volitelně uvolní spravované prostředky. (Zděděno od DbCommand)
DisposeAsync()	Asynchronně disponuje objekt příkazu. (Zděděno od DbCommand)
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
ExecuteDbDataReader(CommandBehavior)	Spustí příkaz proti jeho připojení a vrátí DbDataReader, který lze použít pro přístup k výsledkům. (Zděděno od DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)	Zprostředkovatelé by měli tuto metodu implementovat, aby poskytovali ne výchozí implementaci pro ExecuteReader přetížení. Výchozí implementace vyvolá synchronní ExecuteReader() metodu a vrátí dokončenou úlohu, která blokuje volající vlákno. Výchozí implementace vrátí zrušený úkol, pokud už byl zrušený token zrušení. Výjimky vyvolané ExecuteReader budou oznámeny prostřednictvím vrácené Task Exception vlastnost. Tato metoda přijímá token zrušení, který lze použít k vyžádání operace, aby byla zrušena dříve. Implementace můžou tento požadavek ignorovat. (Zděděno od DbCommand)
ExecuteNonQuery()	Provede příkaz SQL na Connection a vrátí počet ovlivněných řádků.
ExecuteNonQueryAsync()	Asynchronní verze ExecuteNonQuery(), která spustí příkaz proti jeho objektu připojení, vrací počet ovlivněných řádků. Vyvolá ExecuteNonQueryAsync(CancellationToken) pomocí CancellationToken.None. (Zděděno od DbCommand)
ExecuteNonQueryAsync(CancellationToken)	Toto je asynchronní verze ExecuteNonQuery(). Poskytovatelé by měli přepsat příslušnou implementací. Token zrušení může být volitelně ignorován. Výchozí implementace vyvolá synchronní ExecuteNonQuery() metodu a vrátí dokončenou úlohu, která blokuje volající vlákno. Výchozí implementace vrátí zrušený úkol, pokud už byl zrušený token zrušení. Výjimky vyvolané ExecuteNonQuery() budou předány prostřednictvím vrácené vlastnosti Exception úlohy. Nevyvolejte jiné metody a vlastnosti DbCommand objektu, dokud vrácená úloha není dokončena. (Zděděno od DbCommand)
ExecuteReader()	Odešle CommandText do Connection a vytvoří OdbcDataReader.
ExecuteReader(CommandBehavior)	Odešle CommandText do Connectiona vytvoří OdbcDataReader pomocí jedné z hodnot CommandBehavior.
ExecuteReaderAsync()	Asynchronní verze ExecuteReader, která spustí příkaz proti jeho připojení, vrací DbDataReader, které lze použít pro přístup k výsledkům. Vyvolá ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) pomocí CancellationToken.None. (Zděděno od DbCommand)
ExecuteReaderAsync(CancellationToken)	Asynchronní verze ExecuteReader, která spustí příkaz proti jeho připojení, vrací DbDataReader, které lze použít pro přístup k výsledkům. Vyvolá ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Zděděno od DbCommand)
ExecuteReaderAsync(CommandBehavior)	Asynchronní verze ExecuteReader, která spustí příkaz proti jeho připojení, vrací DbDataReader, které lze použít pro přístup k výsledkům. Vyvolá ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Zděděno od DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Vyvolá ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Zděděno od DbCommand)
ExecuteScalar()	Spustí dotaz a vrátí první sloupec prvního řádku v sadě výsledků vrácených dotazem. Další sloupce nebo řádky se ignorují.
ExecuteScalarAsync()	Asynchronní verze ExecuteScalar(), která spustí příkaz a vrátí první sloupec prvního řádku v první vrácené sadě výsledků. Všechny ostatní sloupce, řádky a sady výsledků se ignorují. Vyvolá ExecuteScalarAsync(CancellationToken) pomocí CancellationToken.None. (Zděděno od DbCommand)
ExecuteScalarAsync(CancellationToken)	Toto je asynchronní verze ExecuteScalar(). Poskytovatelé by měli přepsat příslušnou implementací. Token zrušení může být volitelně ignorován. Výchozí implementace vyvolá synchronní ExecuteScalar() metodu a vrátí dokončenou úlohu, která blokuje volající vlákno. Výchozí implementace vrátí zrušený úkol, pokud už byl zrušený token zrušení. Výjimky vyvolané ExecuteScalar budou oznámeny prostřednictvím vrácené task Exception vlastnost. Nevyvolejte jiné metody a vlastnosti DbCommand objektu, dokud vrácená úloha není dokončena. (Zděděno od DbCommand)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetLifetimeService()	Zastaralé. Načte objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetService(Type)	Vrátí objekt, který představuje službu poskytovanou Component nebo jeho Container. (Zděděno od Component)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
InitializeLifetimeService()	Zastaralé. Získá objekt služby životnosti pro řízení zásad životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního objektu MarshalByRefObject. (Zděděno od MarshalByRefObject)
Prepare()	Vytvoří připravenou nebo zkompilovanou verzi příkazu ve zdroji dat.
PrepareAsync(CancellationToken)	Asynchronně vytvoří připravenou (nebo zkompilovanou) verzi příkazu ve zdroji dat. (Zděděno od DbCommand)
ResetCommandTimeout()	Obnoví vlastnost CommandTimeout na výchozí hodnotu.
ToString()	Vrátí String obsahující název Component, pokud existuje. Tato metoda by neměla být přepsána. (Zděděno od Component)

Událost

Disposed

Nastane, když komponenta je uvolněna voláním Dispose() metody. (Zděděno od Component)

Explicitní implementace rozhraní

ICloneable.Clone()	Popis tohoto člena najdete v tématu Clone().
IDbCommand.Connection	Získá nebo nastaví IDbConnection používané touto instancí IDbCommand. (Zděděno od DbCommand)
IDbCommand.CreateParameter()	Vytvoří novou instanci objektu IDbDataParameter. (Zděděno od DbCommand)
IDbCommand.ExecuteReader()	Spustí CommandText proti Connection a vytvoří IDataReader. (Zděděno od DbCommand)
IDbCommand.ExecuteReader(CommandBehavior)	Spustí CommandText proti Connectiona vytvoří IDataReader pomocí jedné z hodnot CommandBehavior. (Zděděno od DbCommand)
IDbCommand.Parameters	Získá IDataParameterCollection. (Zděděno od DbCommand)
IDbCommand.Transaction	Získá nebo nastaví DbTransaction, ve kterém se tento DbCommand objekt spustí. (Zděděno od DbCommand)

Metody rozšíření

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguruje, jak čekají na úlohy vrácené z asynchronního jednorázového použití.

Viz také

• OdbcDataAdapter
• OdbcConnection
• spuštění příkazu