IDbCommand Interfejs

Definicja

Przestrzeń nazw:
System.Data
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 .NET dostawców danych, 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 dziedziczenie klasy implementowania 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, 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 .

Notatki dotyczące implementowania

Aby promować spójność wśród dostawców danych programu .NET Framework, nazwij klasę dziedziczącą w postaci PrvClassname , w której Prv jest jednolity prefiks podany dla wszystkich klas w określonej przestrzeni nazw dostawcy danych programu .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:

Przedmiot 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 z tekstem zapytania, PrvConnection i PrvTransaction.

Właściwości

Nazwa Opis
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 której jest wykonywany obiekt Command dostawcy danych .NET.
UpdatedRowSource

Pobiera lub ustawia sposób stosowania wyników poleceń do DataRow metody , gdy są używane przez Update(DataSet) metodę DbDataAdapter.

Metody

Nazwa Opis
Cancel()

Próbuje anulować wykonanie obiektu IDbCommand.
CreateParameter()

Tworzy nowe wystąpienie IDbDataParameter obiektu.
Dispose()

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

(Odziedziczone po IDisposable)
ExecuteNonQuery()

Wykonuje instrukcję SQL względem obiektu Connection 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 Connectionelementu i 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ż