OdbcCommand Klas

Definitie

Naamruimte:: System.Data.Odbc

Assembly:: System.Data.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Vertegenwoordigt een SQL-instructie of opgeslagen procedure die moet worden uitgevoerd op basis van een gegevensbron. Deze klasse kan niet worden overgenomen.

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

Overname: Object

MarshalByRefObject

Component
OdbcCommand

Overname: Object

MarshalByRefObject

Component

DbCommand
OdbcCommand

Implementeringen: IDbCommand ICloneable IDisposable

Voorbeelden

In het volgende voorbeeld wordt ExecuteNonQuerygebruikt.

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

Opmerkingen

De OdbcCommand klasse biedt de volgende methoden voor het uitvoeren van opdrachten voor een gegevensbron:

Onderdeel	Description
ExecuteReader	Hiermee worden opdrachten uitgevoerd die rijen retourneren.
ExecuteNonQuery	Hiermee worden opdrachten uitgevoerd, zoals SQL INSERT, DELETE, UPDATE en SET-instructies.
ExecuteScalar	Hiermee haalt u één waarde op, bijvoorbeeld een statistische waarde, uit een database.

U kunt de CommandText eigenschap opnieuw instellen en het OdbcCommand object opnieuw gebruiken. U moet echter de OdbcDataReader opdracht sluiten voordat u een nieuwe of vorige opdracht kunt uitvoeren.

Als de uitvoering van de opdracht een fatale OdbcException veroorzaakt, zoals een ernstniveau van SQL Server van 20 of meer, kan OdbcConnection worden gesloten. De gebruiker kan de verbinding echter opnieuw openen en doorgaan.

Constructors

Name	Description
OdbcCommand()	Initialiseert een nieuw exemplaar van de OdbcCommand klasse.
OdbcCommand(String, OdbcConnection, OdbcTransaction)	Initialiseert een nieuw exemplaar van de OdbcCommand klasse met de tekst van de query, een OdbcConnection object en de Transaction.
OdbcCommand(String, OdbcConnection)	Initialiseert een nieuw exemplaar van de OdbcCommand klasse met de tekst van de query en een OdbcConnection object.
OdbcCommand(String)	Initialiseert een nieuw exemplaar van de OdbcCommand klasse met de tekst van de query.

Eigenschappen

Name	Description
CanRaiseEvents	Hiermee wordt een waarde opgehaald die aangeeft of het onderdeel een gebeurtenis kan genereren. (Overgenomen van Component)
CommandText	Hiermee haalt u de SQL-instructie of opgeslagen procedure op die moet worden uitgevoerd op basis van de gegevensbron.
CommandTimeout	Hiermee haalt u de wachttijd (in seconden) op of stelt u deze in voordat u een poging tot het uitvoeren van een opdracht beëindigt en een fout genereert.
CommandType	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft hoe de CommandText eigenschap wordt geïnterpreteerd.
Connection	Hiermee haalt u de OdbcConnection gebruikt door dit exemplaar van de OdbcCommand.
Container	Hiermee haalt u het IContainer bestand op dat de Component. (Overgenomen van Component)
DbConnection	Hiermee haalt u het DbConnection gebruikte bestand op of stelt u deze DbCommandin. (Overgenomen van DbCommand)
DbParameterCollection	Hiermee haalt u de verzameling DbParameter objecten op. (Overgenomen van DbCommand)
DbTransaction	Hiermee haalt u het DbTransaction object op of stelt u het DbCommand object in. (Overgenomen van DbCommand)
DesignMode	Hiermee wordt een waarde opgehaald die aangeeft of de Component momenteel in de ontwerpmodus is. (Overgenomen van Component)
DesignTimeVisible	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het opdrachtobject zichtbaar moet zijn in een aangepast interface-besturingselement.
Events	Hiermee haalt u de lijst met gebeurtenis-handlers op die aan dit Componentbestand zijn gekoppeld. (Overgenomen van Component)
Parameters	Haalt de OdbcParameterCollection.
Site	Haalt of stelt de ISite van de Component. (Overgenomen van Component)
Transaction	Hiermee haalt u de uitvoering op of stelt u deze OdbcTransaction OdbcCommand in.
UpdatedRowSource	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft hoe de updatemethode opdrachtresultaten moet toepassen op datarow.

Methoden

Name	Description
Cancel()	Probeert de uitvoering van een OdbcCommand.
CreateDbParameter()	Hiermee maakt u een nieuw exemplaar van een DbParameter object. (Overgenomen van DbCommand)
CreateObjRef(Type)	Hiermee maakt u een object dat alle relevante informatie bevat die nodig is om een proxy te genereren die wordt gebruikt om te communiceren met een extern object. (Overgenomen van MarshalByRefObject)
CreateParameter()	Hiermee maakt u een nieuw exemplaar van een OdbcParameter object.
Dispose()	Alle resources die worden gebruikt door de Component. (Overgenomen van Component)
Dispose(Boolean)	Publiceert de niet-beheerde resources die worden gebruikt door de Component beheerde resources en brengt eventueel de beheerde resources vrij. (Overgenomen van Component)
Equals(Object)	Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object)
ExecuteDbDataReader(CommandBehavior)	Voert de opdracht uit op basis van de verbinding en retourneert een DbDataReader opdracht die kan worden gebruikt voor toegang tot de resultaten. (Overgenomen van DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)	Providers moeten deze methode implementeren om een niet-standaard implementatie te bieden voor ExecuteReader overbelastingen. De standaardimplementatie roept de synchrone ExecuteReader() methode aan en retourneert een voltooide taak, waardoor de aanroepende thread wordt geblokkeerd. De standaardimplementatie retourneert een geannuleerde taak als een al geannuleerd annuleringstoken is doorgegeven. Uitzonderingen die door ExecuteReader worden gegenereerd, worden gecommuniceerd via de geretourneerde eigenschap Taakuitzondering. Deze methode accepteert een annuleringstoken dat kan worden gebruikt om de bewerking vroeg te annuleren. Implementaties kunnen deze aanvraag negeren. (Overgenomen van DbCommand)
ExecuteNonQuery()	Hiermee wordt een SQL-instructie uitgevoerd op basis van de Connection instructie en wordt het aantal betrokken rijen geretourneerd.
ExecuteNonQueryAsync()	Een asynchrone versie van , waarmee de opdracht wordt uitgevoerd op basis van ExecuteNonQuery()het verbindingsobject, waarmee het aantal betrokken rijen wordt geretourneerd. Roept aan ExecuteNonQueryAsync(CancellationToken) met CancellationToken.None. (Overgenomen van DbCommand)
ExecuteNonQueryAsync(CancellationToken)	Dit is de asynchrone versie van ExecuteNonQuery(). Providers moeten overschrijven met een geschikte implementatie. Het annuleringstoken kan eventueel worden genegeerd. De standaardimplementatie roept de synchrone ExecuteNonQuery() methode aan en retourneert een voltooide taak, waardoor de aanroepende thread wordt geblokkeerd. De standaardimplementatie retourneert een geannuleerde taak als een al geannuleerd annuleringstoken is doorgegeven. Uitzonderingen die worden gegenereerd ExecuteNonQuery() door, worden gecommuniceerd via de geretourneerde eigenschap Taakuitzondering. Roep geen andere methoden en eigenschappen van het `DbCommand` object aan totdat de geretourneerde taak is voltooid. (Overgenomen van DbCommand)
ExecuteReader()	Verzendt de CommandText naar de Connection en bouwt een OdbcDataReader.
ExecuteReader(CommandBehavior)	Verzendt de CommandText naar de Connectionen bouwt een OdbcDataReader met behulp van een van de `CommandBehavior` waarden.
ExecuteReaderAsync()	Een asynchrone versie van, waarmee de opdracht wordt uitgevoerd op basis van ExecuteReaderde verbinding, die een DbDataReader versie retourneert die kan worden gebruikt voor toegang tot de resultaten. Roept aan ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) met CancellationToken.None. (Overgenomen van DbCommand)
ExecuteReaderAsync(CancellationToken)	Een asynchrone versie van, waarmee de opdracht wordt uitgevoerd op basis van ExecuteReaderde verbinding, die een DbDataReader versie retourneert die kan worden gebruikt voor toegang tot de resultaten. ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Roept aan. (Overgenomen van DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)	ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Roept aan. (Overgenomen van DbCommand)
ExecuteReaderAsync(CommandBehavior)	Een asynchrone versie van, waarmee de opdracht wordt uitgevoerd op basis van ExecuteReaderde verbinding, die een DbDataReader versie retourneert die kan worden gebruikt voor toegang tot de resultaten. ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Roept aan. (Overgenomen van DbCommand)
ExecuteScalar()	Hiermee wordt de query uitgevoerd en wordt de eerste kolom van de eerste rij in de resultatenset geretourneerd door de query. Extra kolommen of rijen worden genegeerd.
ExecuteScalarAsync()	Een asynchrone versie van ExecuteScalar(), waarmee de opdracht wordt uitgevoerd en de eerste kolom van de eerste rij in de eerste geretourneerde resultatenset wordt geretourneerd. Alle andere kolommen, rijen en resultatensets worden genegeerd. Roept aan ExecuteScalarAsync(CancellationToken) met CancellationToken.None. (Overgenomen van DbCommand)
ExecuteScalarAsync(CancellationToken)	Dit is de asynchrone versie van ExecuteScalar(). Providers moeten overschrijven met een geschikte implementatie. Het annuleringstoken kan eventueel worden genegeerd. De standaardimplementatie roept de synchrone ExecuteScalar() methode aan en retourneert een voltooide taak, waardoor de aanroepende thread wordt geblokkeerd. De standaardimplementatie retourneert een geannuleerde taak als een al geannuleerd annuleringstoken is doorgegeven. Uitzonderingen die worden gegenereerd door ExecuteScalar, worden gecommuniceerd via de geretourneerde eigenschap Taakuitzondering. Roep geen andere methoden en eigenschappen van het `DbCommand` object aan totdat de geretourneerde taak is voltooid. (Overgenomen van DbCommand)
GetHashCode()	Fungeert als de standaardhashfunctie. (Overgenomen van Object)
GetLifetimeService()	Hiermee haalt u het huidige levensduurserviceobject op waarmee het levensduurbeleid voor dit exemplaar wordt beheerd. (Overgenomen van MarshalByRefObject)
GetService(Type)	Hiermee wordt een object geretourneerd dat een service vertegenwoordigt die wordt geleverd door of door de Component service Container. (Overgenomen van Component)
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
InitializeLifetimeService()	Hiermee haalt u een levensduurserviceobject op om het levensduurbeleid voor dit exemplaar te beheren. (Overgenomen van MarshalByRefObject)
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
MemberwiseClone(Boolean)	Hiermee maakt u een ondiepe kopie van het huidige MarshalByRefObject object. (Overgenomen van MarshalByRefObject)
Prepare()	Hiermee maakt u een voorbereide of gecompileerde versie van de opdracht in de gegevensbron.
ResetCommandTimeout()	Hiermee stelt u de CommandTimeout eigenschap opnieuw in op de standaardwaarde.
ToString()	Retourneert een String met de naam van de Component, indien van toepassing. Deze methode mag niet worden overschreven. (Overgenomen van Component)

gebeurtenis

Name	Description
Disposed	Treedt op wanneer het onderdeel wordt verwijderd door een aanroep naar de Dispose() methode. (Overgenomen van Component)

Expliciete interface-implementaties

Name	Description
ICloneable.Clone()	Zie voor een beschrijving van dit lid Clone().
IDbCommand.Connection	Hiermee haalt u de IDbConnection gebruikt door dit exemplaar van de IDbCommand. (Overgenomen van DbCommand)
IDbCommand.CreateParameter()	Hiermee maakt u een nieuw exemplaar van een IDbDataParameter object.
IDbCommand.CreateParameter()	Hiermee maakt u een nieuw exemplaar van een IDbDataParameter object. (Overgenomen van DbCommand)
IDbCommand.ExecuteReader()	Deze API ondersteunt de productinfrastructuur en is niet bedoeld om rechtstreeks vanuit de code te gebruiken. Hiermee wordt de CommandText bewerking uitgevoerd op basis van de Connection en wordt een IDataReader.
IDbCommand.ExecuteReader()	Hiermee wordt de CommandText bewerking uitgevoerd op basis van de Connection en wordt een IDataReader. (Overgenomen van DbCommand)
IDbCommand.ExecuteReader(CommandBehavior)	Deze API ondersteunt de productinfrastructuur en is niet bedoeld om rechtstreeks vanuit de code te gebruiken. Hiermee wordt de CommandText uitvoering uitgevoerd op basis van de Connectionen wordt een build uitgevoerd IDataReader met behulp van het opgegeven gedrag.
IDbCommand.ExecuteReader(CommandBehavior)	Hiermee worden de CommandText waarden uitgevoerd op basis van de Connectionen wordt er een IDataReader gebouwd met behulp van een van de CommandBehavior waarden. (Overgenomen van DbCommand)
IDbCommand.Parameters	Haalt de IDataParameterCollection. (Overgenomen van DbCommand)
IDbCommand.Transaction	Hiermee haalt u het DbTransaction object op of stelt u het DbCommand object in. (Overgenomen van DbCommand)

Van toepassing op

Zie ook

Feedback

Is deze pagina nuttig?