OdbcCommand Třída

Definice

Obor názvů:

System.Data.Odbc

Sestavení:

System.Data.Odbc.dll

Balíček:

System.Data.Odbc v8.0.0

Zdroj:

OdbcCommand.cs

Představuje příkaz SQL nebo uloženou proceduru, která se má provést proti zdroji dat. Tato třída se nemůže dě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

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 provádění příkazů se zdrojem dat:

Položka	Popis
ExecuteReader	Spustí příkazy, které vrací řá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 agregovanou hodnotu.

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

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

Konstruktory

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

Vlastnosti

CommandText	Získá nebo nastaví sql příkaz nebo uloženou proceduru provést 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á označuje, jak CommandText je interpretována vlastnost.
Connection	Získá nebo nastaví použitou OdbcConnection touto instancí objektu OdbcCommand.
DbConnection	Získá nebo nastaví DbConnection použitý 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 tento DbCommand objekt provede. (Zděděno od DbCommand)
DesignTimeVisible	Získá nebo nastaví hodnotu, která označuje, zda příkaz objektu by měl být viditelný v přizpůsobeném ovládacím prvku rozhraní.
Parameters	Získá .OdbcParameterCollection
Transaction	Získá nebo nastaví, OdbcTransaction v rámci kterého se OdbcCommand provede.
UpdatedRowSource	Získá nebo nastaví hodnotu, která určuje, jak Update metoda má použít výsledky příkazu DataRow.

Metody

Cancel()	Pokusí se zrušit spuštění objektu OdbcCommand.
CreateDbParameter()	Vytvoří novou instanci objektu DbParameter . (Zděděno od DbCommand)
CreateParameter()	Vytvoří novou instanci objektu OdbcParameter .
Dispose()	Provede aplikací definované úlohy spojené s 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 nástrojem a volitelně uvolní spravované prostředky. (Zděděno od DbCommand)
DisposeAsync()	Asynchronně rozdělí objekt příkazu. (Zděděno od DbCommand)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
ExecuteDbDataReader(CommandBehavior)	Spustí příkaz proti jeho připojení a vrátí DbDataReader příkaz, který lze použít pro přístup k výsledkům. (Zděděno od DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)	Zprostředkovatelé by měli implementovat tuto metodu, aby poskytovala pro přetížení jinou než výchozí implementaci ExecuteReader . 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šenou úlohu, pokud je předán již zrušený token zrušení. Výjimky vyvolané nástrojem ExecuteReader budou sděleny prostřednictvím vlastnosti vrácené výjimky úlohy. Tato metoda přijímá token zrušení, který lze použít k žádosti o předčasné zrušení operace. Implementace můžou tento požadavek ignorovat. (Zděděno od DbCommand)
ExecuteNonQuery()	Spustí příkaz SQL proti Connection a vrátí počet ovlivněných řádků.
ExecuteNonQueryAsync()	Asynchronní verze nástroje ExecuteNonQuery(), která provede příkaz proti objektu připojení a vrátí počet ovlivněných řádků. Vyvolá pomocí ExecuteNonQueryAsync(CancellationToken) CancellationToken.None. (Zděděno od DbCommand)
ExecuteNonQueryAsync(CancellationToken)	Toto je asynchronní verze nástroje 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šenou úlohu, pokud je předán již zrušený token zrušení. Výjimky vyvolané nástrojem ExecuteNonQuery() budou sděleny prostřednictvím vrácené vlastnosti Výjimka úkolu. Nevyvolávej jiné metody a vlastnosti objektu DbCommand , dokud nebude dokončena vrácená úloha. (Zděděno od DbCommand)
ExecuteReader()	Odešle do CommandText objektu Connection a vytvoří OdbcDataReader.
ExecuteReader(CommandBehavior)	Odešle hodnotu CommandText do a vytvoří OdbcDataReader objekt pomocí jedné z CommandBehaviorConnectionhodnot.
ExecuteReaderAsync()	Asynchronní verze nástroje ExecuteReader, která spustí příkaz proti svému připojení a vrátí DbDataReader příkaz, který lze použít pro přístup k výsledkům. Vyvolá pomocí ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) CancellationToken.None. (Zděděno od DbCommand)
ExecuteReaderAsync(CancellationToken)	Asynchronní verze nástroje ExecuteReader, která spustí příkaz proti svému připojení a vrátí DbDataReader příkaz, který lze použít pro přístup k výsledkům. ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Vyvolá . (Zděděno od DbCommand)
ExecuteReaderAsync(CommandBehavior)	Asynchronní verze nástroje ExecuteReader, která spustí příkaz proti svému připojení a vrátí DbDataReader příkaz, který lze použít pro přístup k výsledkům. ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Vyvolá . (Zděděno od DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)	ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Vyvolá . (Zděděno od DbCommand)
ExecuteScalar()	Spustí dotaz a vrátí první sloupec prvního řádku v sadě výsledků vrácené dotazem. Další sloupce nebo řádky se ignorují.
ExecuteScalarAsync()	Asynchronní verze nástroje 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á pomocí ExecuteScalarAsync(CancellationToken) CancellationToken.None. (Zděděno od DbCommand)
ExecuteScalarAsync(CancellationToken)	Toto je asynchronní verze nástroje 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šenou úlohu, pokud je předán již zrušený token zrušení. Výjimky vyvolané nástrojem ExecuteScalar budou sděleny prostřednictvím vrácené vlastnosti Task Exception. Nevyvolávej jiné metody a vlastnosti objektu DbCommand , dokud nebude dokončena vrácená úloha. (Zděděno od DbCommand)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
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()	CommandTimeout Obnoví vlastnost na výchozí hodnotu.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Explicitní implementace rozhraní

ICloneable.Clone()

Popis tohoto člena najdete v tématu Clone().

Viz také

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