IDbCommand Interfejs

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Data
Zestaw:
System.Data.Common.dll
Zestaw:
System.Data.dll
Zestaw:
netstandard.dll

Reprezentuje instrukcję SQL wykonywaną podczas nawiązywania połączenia ze źródłem danych i jest 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
IDisposable

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 SqlDataReaderelement , 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 zaimplementowanie 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 implementujące IDbCommand interfejs.

Klasy implementujące IDbCommand muszą implementować wszystkie jej elementy członkowskie i zwykle definiują dodatkowe elementy członkowskie, aby dodać funkcjonalność specyficzną 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ść między dostawcami danych .NET Framework, nazwij klasę dziedzicującą 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.

Podczas dziedziczenia 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(ciąg cmdText, Połączenie PrvConnection) Inicjuje nowe wystąpienie klasy PrvCommand tekstem zapytania i prvConnection.
PrvCommand(ciąg 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 wygenerowania 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 polecenia do DataRow metody w przypadku użycia przez Update(DataSet) metodę DbDataAdapter.

Metody

Cancel()

Próbuje anulować wykonanie obiektu 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 platformy .NET i zwraca liczbę wierszy, których dotyczy problem.
ExecuteReader()

Wykonuje element CommandText względem elementu Connection i kompiluje element IDataReader.
ExecuteReader(CommandBehavior)

Wykonuje obiekt CommandText względem elementu Connectioni tworzy obiekt 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ż