Udostępnij za pośrednictwem


IDbCommand Interfejs

Definicja

Reprezentuje instrukcję SQL wykonywaną podczas nawiązywania połączenia ze źródłem danych i implementowana przez dostawców danych platformy .NET, którzy uzyskują dostęp do relacyjnych baz danych.

public interface class IDbCommand : IDisposable
public interface IDbCommand : IDisposable
type IDbCommand = interface
    interface IDisposable
Public Interface IDbCommand
Implements IDisposable
Pochodne
Implementuje

Przykłady

Poniższy przykład tworzy wystąpienia klas pochodnych, SqlConnection, SqlCommandi SqlDataReader. Przykład odczytuje dane, zapisuj je w konsoli. Na koniec przykład zamyka element SqlDataReader, a następnie 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

Uwagi

Interfejs IDbCommand umożliwia dziedziczonej klasie implementowanie klasy Command, która reprezentuje instrukcję SQL wykonywaną w źródle danych. Aby uzyskać więcej informacji na temat klas poleceń, zobacz Wykonywanie polecenia.

Aplikacja nie tworzy bezpośrednio wystąpienia interfejsu IDbCommand , ale tworzy wystąpienie klasy, która implementuje IDbCommand interfejs.

Klasy implementujące IDbCommand muszą implementować wszystkie jej elementy członkowskie i zazwyczaj definiują dodatkowe elementy członkowskie w celu dodania funkcji specyficznych dla dostawcy. Na przykład IDbCommand interfejs definiuje metodę ExecuteNonQuery . Z kolei SqlCommand klasa dziedziczy tę metodę, a także definiuje metodę ExecuteXmlReader .

Uwagi dotyczące implementowania

Aby podwyższyć spójność wśród dostawców danych .NET Framework, nadaj nazwę dziedziczonej klasie w postaciPrvClassname, w której Prv jest jednolity prefiks nadany wszystkim klasom w określonej przestrzeni nazw dostawcy danych .NET Framework. Na przykład Sql jest prefiksem SqlCommand klasy w System.Data.SqlClient przestrzeni nazw.

Po dziedziczeniu z interfejsu IDbCommand należy zaimplementować następujące konstruktory:

Element Opis
PrvCommand() Inicjuje nowe wystąpienie klasy PrvCommand.
PrvCommand(ciąg cmdText) Inicjuje nowe wystąpienie klasy PrvCommand tekstem zapytania.
PrvCommand(parametry cmdText, Połączenie PrvConnection) Inicjuje nowe wystąpienie klasy PrvCommand tekstem zapytania i prvConnection.
PrvCommand(parametry cmdText, Połączenie PrvConnection, Transakcja PrvTransaction) Inicjuje nowe wystąpienie klasy PrvCommand tekstem zapytania, prvConnection i prvTransaction.

Właściwości

CommandText

Pobiera lub ustawia polecenie tekstowe do uruchomienia względem źródła danych.

CommandTimeout

Pobiera lub ustawia czas oczekiwania (w sekundach) przed zakończeniem próby wykonania polecenia i wygenerowaniem błędu.

CommandType

Wskazuje lub określa sposób CommandText interpretowania właściwości.

Connection

Pobiera lub ustawia IDbConnection wartość używaną przez to wystąpienie klasy IDbCommand.

Parameters

Pobiera klasę IDataParameterCollection.

Transaction

Pobiera lub ustawia transakcję, w ramach której Command jest wykonywany obiekt dostawcy danych platformy .NET.

UpdatedRowSource

Pobiera lub ustawia sposób stosowania wyników poleceń do DataRowUpdate(DataSet)DbDataAdaptermetody .

Metody

Cancel()

Próbuje anulować wykonanie elementu IDbCommand.

CreateParameter()

Tworzy nowe wystąpienie IDbDataParameter obiektu.

Dispose()

Wykonuje zdefiniowane przez aplikację zadania skojarzone ze zwalnianiem lub resetowaniem zasobów niezarządzanych.

(Odziedziczone po IDisposable)
ExecuteNonQuery()

Wykonuje instrukcję SQL względem Connection obiektu dostawcy danych .NET i zwraca liczbę wierszy, których dotyczy problem.

ExecuteReader()

Wykonuje element CommandText względem elementu Connection i tworzy element IDataReader.

ExecuteReader(CommandBehavior)

Wykonuje element CommandText względem elementu Connectioni tworzy element IDataReader przy użyciu jednej z CommandBehavior wartości.

ExecuteScalar()

Wykonuje zapytanie i zwraca pierwszą kolumnę pierwszego wiersza w zestawie wyników zwróconym przez zapytanie. Dodatkowe kolumny lub wiersze są ignorowane.

Prepare()

Tworzy przygotowaną (lub skompilowana) wersję polecenia w źródle danych.

Dotyczy

Zobacz też