OdbcCommand Třída

Definice

Obor názvů:

System.Data.Odbc

Sestavení:

System.Data.Odbc.dll

Balíček:

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

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

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 můžete resetovat CommandText a znovu použít OdbcCommand objekt. Před spuštěním nového nebo předchozího příkazu však musíte zavřít OdbcDataReader příkaz.

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

Konstruktory

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

Vlastnosti

Name	Description
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 je vlastnost interpretována.
Connection	Získá nebo nastaví OdbcConnection používané touto instancí OdbcCommand.
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.
Parameters	OdbcParameterCollectionZíská .
Transaction	Získá nebo nastaví, OdbcTransaction ve kterém se OdbcCommand provede.
UpdatedRowSource	Získá nebo nastaví hodnotu, která určuje, jak metoda Update má použít výsledky příkazu dataRow.

Metody

Name	Description
Cancel()	Pokusí se zrušit spuštění .OdbcCommand
CreateParameter()	Vytvoří novou instanci objektu OdbcParameter .
ExecuteNonQuery()	Provede příkaz SQL na Connection základě a vrátí počet ovlivněnýchřádkůch
ExecuteReader()	CommandText Odešle na Connection a vytvoří .OdbcDataReader
ExecuteReader(CommandBehavior)	CommandText Odešle hodnotu do objektu Connectiona vytvoří některou OdbcDataReader z CommandBehavior hodnot.
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í.
Prepare()	Vytvoří připravenou nebo zkompilovanou verzi příkazu ve zdroji dat.
ResetCommandTimeout()	CommandTimeout Obnoví vlastnost na výchozí hodnotu.

Explicitní implementace rozhraní

Name	Description
ICloneable.Clone()	Popis tohoto člena naleznete v tématu Clone().

Viz také

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