OdbcCommand Klass

Definition

Namnområde:
System.Data.Odbc
Sammansättning:
System.Data.dll

Representerar en SQL-instruktion eller lagrad procedur som ska köras mot en datakälla. Det går inte att ärva den här klassen.

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
Arv
Object
MarshalByRefObject
Component
OdbcCommand
Arv
Object
MarshalByRefObject
Component
DbCommand
OdbcCommand
Implementeringar
IDbCommand ICloneable IDisposable

Exempel

I följande exempel används 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

Kommentarer

Klassen OdbcCommand innehåller följande metoder för att köra kommandon mot en datakälla:

Objekt Description
ExecuteReader Kör kommandon som returnerar rader.
ExecuteNonQuery Kör kommandon som SQL INSERT-, DELETE-, UPDATE- och SET-instruktioner.
ExecuteScalar Hämtar ett enda värde, till exempel ett aggregeringsvärde, från en databas.

Du kan återställa CommandText egenskapen och återanvända objektet OdbcCommand . Du måste dock stänga OdbcDataReader innan du kan köra ett nytt eller tidigare kommando.

Om körningen av kommandot orsakar ett allvarligt OdbcException till exempel en SQL Server allvarlighetsgrad på 20 eller mer kan OdbcConnection stängas. Användaren kan dock öppna anslutningen igen och fortsätta.

Konstruktorer

Name Description
OdbcCommand()

Initierar en ny instans av OdbcCommand klassen.
OdbcCommand(String, OdbcConnection, OdbcTransaction)

Initierar en ny instans av OdbcCommand klassen med texten i frågan, ett OdbcConnection objekt och Transaction.
OdbcCommand(String, OdbcConnection)

Initierar en ny instans av OdbcCommand klassen med texten i frågan och ett OdbcConnection objekt.
OdbcCommand(String)

Initierar en ny instans av OdbcCommand klassen med texten i frågan.

Egenskaper

Name Description
CanRaiseEvents

Hämtar ett värde som anger om komponenten kan generera en händelse.

(Ärvd från Component)
CommandText

Hämtar eller anger sql-instruktionen eller den lagrade proceduren som ska köras mot datakällan.
CommandTimeout

Hämtar eller anger väntetiden (i sekunder) innan ett försök att köra ett kommando avslutas och ett fel genereras.
CommandType

Hämtar eller anger ett värde som anger hur egenskapen CommandText tolkas.
Connection

Hämtar eller anger den OdbcConnection som används av den här instansen OdbcCommandav .
Container

Hämtar som IContainer innehåller Component.

(Ärvd från Component)
DbConnection

Hämtar eller anger den DbConnection som används av den här DbCommand.

(Ärvd från DbCommand)
DbParameterCollection

Hämtar samlingen med DbParameter objekt.

(Ärvd från DbCommand)
DbTransaction

Hämtar eller anger inom DbTransaction vilken det här DbCommand objektet körs.

(Ärvd från DbCommand)
DesignMode

Hämtar ett värde som anger om det Component för närvarande är i designläge.

(Ärvd från Component)
DesignTimeVisible

Hämtar eller anger ett värde som anger om kommandoobjektet ska visas i en anpassad gränssnittskontroll.
Events

Hämtar listan över händelsehanterare som är kopplade till den här Component.

(Ärvd från Component)
Parameters

OdbcParameterCollectionHämtar .
Site

Hämtar eller ställer in ISite i Component.

(Ärvd från Component)
Transaction

Hämtar eller anger inom OdbcTransaction vilken OdbcCommand körs.
UpdatedRowSource

Hämtar eller anger ett värde som anger hur metoden Update ska tillämpa kommandoresultat på DataRow.

Metoder

Name Description
Cancel()

Försöker avbryta körningen av en OdbcCommand.
CreateDbParameter()

Skapar en ny instans av ett DbParameter objekt.

(Ärvd från DbCommand)
CreateObjRef(Type)

Skapar ett objekt som innehåller all relevant information som krävs för att generera en proxy som används för att kommunicera med ett fjärrobjekt.

(Ärvd från MarshalByRefObject)
CreateParameter()

Skapar en ny instans av ett OdbcParameter objekt.
Dispose()

Släpper alla resurser som används av Component.

(Ärvd från Component)
Dispose(Boolean)

Släpper de ohanterade resurser som används av Component och släpper eventuellt de hanterade resurserna.

(Ärvd från Component)
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
ExecuteDbDataReader(CommandBehavior)

Kör kommandot mot anslutningen och returnerar en DbDataReader som kan användas för att komma åt resultaten.

(Ärvd från DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

Leverantörer bör implementera den här metoden för att tillhandahålla en icke-standardimplementering för ExecuteReader överlagringar.

Standardimplementeringen anropar den synkrona ExecuteReader() metoden och returnerar en slutförd uppgift som blockerar den anropande tråden. Standardimplementeringen returnerar en avbruten aktivitet om den skickas en redan avbruten annulleringstoken. Undantag som genereras av ExecuteReader kommuniceras via den returnerade egenskapen Aktivitetsfel.

Den här metoden accepterar en annulleringstoken som kan användas för att begära att åtgärden avbryts tidigt. Implementeringar kan ignorera den här begäran.

(Ärvd från DbCommand)
ExecuteNonQuery()

Kör en SQL-instruktion mot Connection och returnerar antalet rader som påverkas.
ExecuteNonQueryAsync()

En asynkron version av ExecuteNonQuery(), som kör kommandot mot dess anslutningsobjekt och returnerar antalet rader som påverkas.

Anropar ExecuteNonQueryAsync(CancellationToken) med CancellationToken.None.

(Ärvd från DbCommand)
ExecuteNonQueryAsync(CancellationToken)

Det här är den asynkrona versionen av ExecuteNonQuery(). Leverantörer bör åsidosätta med en lämplig implementering. Annulleringstoken kan eventuellt ignoreras.

Standardimplementeringen anropar den synkrona ExecuteNonQuery() metoden och returnerar en slutförd uppgift som blockerar den anropande tråden. Standardimplementeringen returnerar en avbruten aktivitet om den skickas en redan avbruten annulleringstoken. Undantag som genereras av ExecuteNonQuery() kommer att kommuniceras via den returnerade egenskapen Aktivitetsfel.

Anropa inte andra metoder och egenskaper för DbCommand objektet förrän den returnerade aktiviteten har slutförts.

(Ärvd från DbCommand)
ExecuteReader()

CommandText Skickar till Connection och skapar en OdbcDataReader.
ExecuteReader(CommandBehavior)

CommandText Skickar till Connectionoch skapar ett OdbcDataReader med ett av CommandBehavior värdena.
ExecuteReaderAsync()

En asynkron version av ExecuteReader, som kör kommandot mot dess anslutning och returnerar en DbDataReader som kan användas för att komma åt resultaten.

Anropar ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) med CancellationToken.None.

(Ärvd från DbCommand)
ExecuteReaderAsync(CancellationToken)

En asynkron version av ExecuteReader, som kör kommandot mot dess anslutning och returnerar en DbDataReader som kan användas för att komma åt resultaten.

Anropar ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

(Ärvd från DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)

Anropar ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

(Ärvd från DbCommand)
ExecuteReaderAsync(CommandBehavior)

En asynkron version av ExecuteReader, som kör kommandot mot dess anslutning och returnerar en DbDataReader som kan användas för att komma åt resultaten.

Anropar ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

(Ärvd från DbCommand)
ExecuteScalar()

Kör frågan och returnerar den första kolumnen i den första raden i resultatuppsättningen som returneras av frågan. Ytterligare kolumner eller rader ignoreras.
ExecuteScalarAsync()

En asynkron version av ExecuteScalar(), som kör kommandot och returnerar den första kolumnen på den första raden i den första returnerade resultatuppsättningen. Alla andra kolumner, rader och resultatuppsättningar ignoreras.

Anropar ExecuteScalarAsync(CancellationToken) med CancellationToken.None.

(Ärvd från DbCommand)
ExecuteScalarAsync(CancellationToken)

Det här är den asynkrona versionen av ExecuteScalar(). Leverantörer bör åsidosätta med en lämplig implementering. Annulleringstoken kan eventuellt ignoreras.

Standardimplementeringen anropar den synkrona ExecuteScalar() metoden och returnerar en slutförd uppgift som blockerar den anropande tråden. Standardimplementeringen returnerar en avbruten aktivitet om den skickas en redan avbruten annulleringstoken. Undantag som genereras av ExecuteScalar kommuniceras via den returnerade egenskapen Aktivitetsfel.

Anropa inte andra metoder och egenskaper för DbCommand objektet förrän den returnerade aktiviteten har slutförts.

(Ärvd från DbCommand)
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetLifetimeService()

Hämtar det aktuella livslängdstjänstobjektet som styr livslängdsprincipen för den här instansen.

(Ärvd från MarshalByRefObject)
GetService(Type)

Returnerar ett objekt som representerar en tjänst som tillhandahålls av Component eller av dess Container.

(Ärvd från Component)
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
InitializeLifetimeService()

Hämtar ett tjänstobjekt för livslängd för att styra livslängdsprincipen för den här instansen.

(Ärvd från MarshalByRefObject)
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
MemberwiseClone(Boolean)

Skapar en ytlig kopia av det aktuella MarshalByRefObject objektet.

(Ärvd från MarshalByRefObject)
Prepare()

Skapar en förberedd eller kompilerad version av kommandot i datakällan.
ResetCommandTimeout()

Återställer egenskapen CommandTimeout till standardvärdet.
ToString()

Returnerar ett String som innehåller namnet på Component, om det finns. Den här metoden bör inte åsidosättas.

(Ärvd från Component)

Händelser

Name Description
Disposed

Inträffar när komponenten tas bort av ett anrop till Dispose() metoden.

(Ärvd från Component)

Explicita gränssnittsimplementeringar

Name Description
ICloneable.Clone()

En beskrivning av den här medlemmen finns i Clone().
IDbCommand.Connection

Hämtar eller anger den IDbConnection som används av den här instansen IDbCommandav .

(Ärvd från DbCommand)
IDbCommand.CreateParameter()

Skapar en ny instans av ett IDbDataParameter objekt.
IDbCommand.CreateParameter()

Skapar en ny instans av ett IDbDataParameter objekt.

(Ärvd från DbCommand)
IDbCommand.ExecuteReader()

Detta API stöder produktinfrastrukturen och är inte avsett att användas direkt från koden.

CommandText Kör mot Connection och skapar en IDataReader.
IDbCommand.ExecuteReader()

CommandText Kör mot Connection och skapar en IDataReader.

(Ärvd från DbCommand)
IDbCommand.ExecuteReader(CommandBehavior)

Detta API stöder produktinfrastrukturen och är inte avsett att användas direkt från koden.

CommandText Kör mot Connection, och skapar en IDataReader med det angivna beteendet.
IDbCommand.ExecuteReader(CommandBehavior)

CommandText Kör mot Connection, och skapar ett IDataReader med något av CommandBehavior värdena.

(Ärvd från DbCommand)
IDbCommand.Parameters

IDataParameterCollectionHämtar .

(Ärvd från DbCommand)
IDbCommand.Transaction

Hämtar eller anger inom DbTransaction vilken det här DbCommand objektet körs.

(Ärvd från DbCommand)

Gäller för

Se även