IDbCommand Interface

Definitie

Naamruimte:
System.Data
Assembly:
System.Data.dll
Assembly:
netstandard.dll

Vertegenwoordigt een SQL-instructie die wordt uitgevoerd terwijl deze is verbonden met een gegevensbron en wordt geïmplementeerd door .NET gegevensproviders die toegang hebben tot relationele databases.

public interface class IDbCommand : IDisposable
public interface IDbCommand : IDisposable
type IDbCommand = interface
    interface IDisposable
Public Interface IDbCommand
Implements IDisposable
Afgeleid
Implementeringen
IDisposable

Voorbeelden

In het volgende voorbeeld worden exemplaren van de afgeleide klassen, SqlConnection, SqlCommanden SqlDataReader. Het voorbeeld leest de gegevens door en schrijft deze naar de console. Ten slotte sluit het voorbeeld de SqlDataReader, en vervolgens de SqlConnection.

private static void ReadOrderData(string connectionString)
{
    string queryString =
        "SELECT OrderID, CustomerID FROM dbo.Orders;";
    using (SqlConnection connection = new SqlConnection(
               connectionString))
    {
        SqlCommand command = new SqlCommand(
            queryString, connection);
        connection.Open();
        using(SqlDataReader reader = command.ExecuteReader())
        {
            while (reader.Read())
            {
                Console.WriteLine(String.Format("{0}, {1}",
                    reader[0], reader[1]));
            }
        }
    }
}

Public Sub ReadOrderData(ByVal connectionString As String)
    Dim queryString As String = _
        "SELECT OrderID, CustomerID FROM dbo.Orders;"
    Using connection As New SqlConnection(connectionString)
        Dim command As New SqlCommand(queryString, connection)
        connection.Open()
        Dim reader As SqlDataReader = command.ExecuteReader()
        Try
            While reader.Read()
                Console.WriteLine(String.Format("{0}, {1}", _
                    reader(0), reader(1)))
            End While
        Finally
            ' Always call Close when done reading.
            reader.Close()
        End Try
    End Using
End Sub

Opmerkingen

Met de IDbCommand interface kan een overnemende klasse een opdrachtklasse implementeren, die een SQL-instructie vertegenwoordigt die wordt uitgevoerd in een gegevensbron. Zie Een opdracht uitvoeren voor meer informatie over opdrachtklassen.

Een toepassing maakt geen exemplaar van de IDbCommand interface rechtstreeks, maar maakt een exemplaar van een klasse die de IDbCommand interface implementeert.

Klassen die worden geïmplementeerd IDbCommand , moeten alle leden implementeren en definiëren doorgaans extra leden om providerspecifieke functionaliteit toe te voegen. De IDbCommand interface definieert bijvoorbeeld de ExecuteNonQuery methode. De klasse neemt deze methode op zijn beurt SqlCommand over en definieert ook de ExecuteXmlReader methode.

Notities voor uitvoerders

Als u consistentie tussen .NET Framework-gegevensproviders wilt bevorderen, geeft u de overnemende klasse een naam in de vorm PrvClassname waarbij Prv het uniforme voorvoegsel is dat aan alle klassen in een specifieke naamruimte van .NET Framework-gegevensprovider wordt gegeven. Is bijvoorbeeld Sql het voorvoegsel van de SqlCommand klasse in de System.Data.SqlClient naamruimte.

Wanneer u de IDbCommand interface over neemt, moet u de volgende constructors implementeren:

Artikel Beschrijving
PrvCommand() Initialiseert een nieuw exemplaar van de klasse PrvCommand.
PrvCommand(tekenreeks cmdText) Initialiseert een nieuw exemplaar van de klasse PrvCommand met de tekst van de query.
PrvCommand(tekenreeks cmdText, PrvConnection-verbinding) Initialiseert een nieuw exemplaar van de klasse PrvCommand met de tekst van de query en een PrvConnection.
PrvCommand(tekenreeks cmdText, PrvConnection-verbinding, PrvTransaction-transactie) Initialiseert een nieuw exemplaar van de klasse PrvCommand met de tekst van de query, een PrvConnection en de PrvTransaction.

Eigenschappen

Name Description
CommandText

Hiermee haalt u de tekstopdracht op die moet worden uitgevoerd op de gegevensbron.
CommandTimeout

Hiermee haalt u de wachttijd (in seconden) op of stelt u deze in voordat u de poging om een opdracht uit te voeren beëindigt en een fout genereert.
CommandType

Geeft aan of geeft aan hoe de CommandText eigenschap wordt geïnterpreteerd.
Connection

Hiermee haalt u de IDbConnection gebruikt door dit exemplaar van de IDbCommand.
Parameters

Haalt de IDataParameterCollection.
Transaction

Hiermee wordt de transactie opgehaald of ingesteld waarin het Command-object van een .NET gegevensprovider wordt uitgevoerd.
UpdatedRowSource

Hiermee wordt opgehaald of ingesteld hoe de opdrachtresultaten worden toegepast op de DataRow wanneer deze worden gebruikt door de Update(DataSet) methode van een DbDataAdapter.

Methoden

Name Description
Cancel()

Pogingen om de uitvoering van een IDbCommand.
CreateParameter()

Hiermee maakt u een nieuw exemplaar van een IDbDataParameter object.
Dispose()

Voert door de toepassing gedefinieerde taken uit die zijn gekoppeld aan het vrijmaken, vrijgeven of opnieuw instellen van onbeheerde resources.

(Overgenomen van IDisposable)
ExecuteNonQuery()

Voert een SQL-instructie uit op het Connection-object van een .NET gegevensprovider en retourneert het aantal betrokken rijen.
ExecuteReader()

Hiermee wordt de CommandText bewerking uitgevoerd op basis van de Connection en wordt een IDataReader.
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.
ExecuteScalar()

Voert de query uit en retourneert de eerste kolom van de eerste rij in de resultatenset die door de query wordt geretourneerd. Extra kolommen of rijen worden genegeerd.
Prepare()

Hiermee maakt u een voorbereide (of gecompileerde) versie van de opdracht op de gegevensbron.

Van toepassing op

Zie ook