OleDbCommand Klasa

Definicja

Reprezentuje instrukcję SQL lub procedurę składowaną do wykonania względem źródła danych.

public ref class OleDbCommand sealed : System::Data::Common::DbCommand, ICloneable
public ref class OleDbCommand sealed : System::Data::Common::DbCommand, ICloneable, IDisposable
public ref class OleDbCommand sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbCommand
public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable
public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable, IDisposable
public sealed class OleDbCommand : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbCommand
type OleDbCommand = class
    inherit DbCommand
    interface IDbCommand
    interface IDisposable
    interface ICloneable
type OleDbCommand = class
    inherit Component
    interface ICloneable
    interface IDbCommand
    interface IDisposable
type OleDbCommand = class
    inherit DbCommand
    interface ICloneable
    interface IDbCommand
    interface IDisposable
Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable
Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable, IDisposable
Public NotInheritable Class OleDbCommand
Inherits Component
Implements ICloneable, IDbCommand, IDisposable
Dziedziczenie
OleDbCommand
Dziedziczenie
Dziedziczenie
Implementuje

Przykłady

W poniższym przykładzie użyto elementów OleDbCommand, wzdłuż OleDbDataAdapter i OleDbConnection, aby wybrać wiersze z bazy danych programu Access. Wypełnione DataSet są następnie zwracane. Przykład jest przekazywany zainicjowany DataSet, parametry połączenia, ciąg zapytania, który jest instrukcją SQL SELECT i ciąg, który jest nazwą źródłowej tabeli bazy danych.

public void ReadMyData(string connectionString)
{
    string queryString = "SELECT OrderID, CustomerID FROM Orders";
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbCommand command = new OleDbCommand(queryString, connection);
        connection.Open();
        OleDbDataReader reader = command.ExecuteReader();

        while (reader.Read())
        {
            Console.WriteLine(reader.GetInt32(0) + ", " + reader.GetString(1));
        }
        // always call Close when done reading.
        reader.Close();
    }
}
Public Sub ReadMyData(ByVal connectionString As String)
    Dim queryString As String = "SELECT OrderID, CustomerID FROM Orders"
    Using connection As New OleDbConnection(connectionString)
        Dim command As New OleDbCommand(queryString, connection)

        connection.Open()

        Dim reader As OleDbDataReader = command.ExecuteReader()
        While reader.Read()
            Console.WriteLine(reader.GetInt32(0).ToString() + ", " _
               + reader.GetString(1))
        End While

        ' always call Close when done reading.
        reader.Close()
    End Using
End Sub

Uwagi

Po utworzeniu OleDbCommand wystąpienia obiektu właściwości odczytu/zapisu są ustawiane na ich wartości początkowe. Aby uzyskać listę tych wartości, zobacz OleDbCommand konstruktor.

OleDbCommand funkcje następujące metody wykonywania poleceń w źródle danych:

Element Opis
ExecuteReader Wykonuje polecenia zwracające wiersze. ExecuteReader może nie mieć efektu, który ma być używany do wykonywania poleceń, takich jak instrukcje SQL SET.
ExecuteNonQuery Wykonuje polecenia, takie jak INSTRUKCJe SQL INSERT, DELETE, UPDATE i SET.
ExecuteScalar Pobiera pojedynczą wartość, na przykład zagregowaną wartość z bazy danych.

Możesz zresetować CommandText właściwość i ponownie użyć OleDbCommand obiektu. Należy jednak zamknąć przed OleDbDataReader wykonaniem nowego lub poprzedniego polecenia.

Jeśli krytyczny OleDbException (na przykład poziom ważności SQL Server 20 lub większy) jest generowany przez metodę wykonującą metodę OleDbCommand, OleDbConnectionpołączenie może zostać zamknięte. Użytkownik może jednak ponownie otworzyć połączenie i kontynuować.

Konstruktory

OleDbCommand()

Inicjuje nowe wystąpienie klasy OleDbCommand.

OleDbCommand(String)

Inicjuje OleDbCommand nowe wystąpienie klasy tekstem zapytania.

OleDbCommand(String, OleDbConnection)

Inicjuje nowe wystąpienie OleDbCommand klasy przy użyciu tekstu zapytania i .OleDbConnection

OleDbCommand(String, OleDbConnection, OleDbTransaction)

Inicjuje nowe wystąpienie OleDbCommand klasy przy użyciu tekstu zapytania , OleDbConnectioni .Transaction

Właściwości

CanRaiseEvents

Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie.

(Odziedziczone po Component)
CommandText

Pobiera lub ustawia instrukcję SQL lub procedurę składowaną do wykonania w źródle danych.

CommandTimeout

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

CommandType

Pobiera lub ustawia wartość wskazującą sposób CommandText interpretowania właściwości.

Connection

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

Container

Pobiera element IContainer zawierający element Component.

(Odziedziczone po Component)
DbConnection

Pobiera lub ustawia wartość używaną przez ten DbCommandelement DbConnection .

(Odziedziczone po DbCommand)
DbParameterCollection

Pobiera kolekcję DbParameter obiektów.

(Odziedziczone po DbCommand)
DbTransaction

Pobiera lub ustawia obiekt DbTransaction , w którym jest wykonywany ten DbCommand obiekt.

(Odziedziczone po DbCommand)
DesignMode

Pobiera wartość wskazującą, czy Component element jest obecnie w trybie projektowania.

(Odziedziczone po Component)
DesignTimeVisible

Pobiera lub ustawia wartość wskazującą, czy obiekt polecenia powinien być widoczny w dostosowanej kontrolce Windows Forms Designer.

Events

Pobiera listę programów obsługi zdarzeń dołączonych do tego Componentelementu .

(Odziedziczone po Component)
Parameters

Pobiera klasę OleDbParameterCollection.

Site

Pobiera lub ustawia wartość ISite .Component

(Odziedziczone po Component)
Transaction

Pobiera lub ustawia OleDbTransaction element, w którym OleDbCommand jest wykonywane.

UpdatedRowSource

Pobiera lub ustawia sposób stosowania wyników poleceń do DataRow metody w przypadku użycia przez Update metodę OleDbDataAdapter.

Metody

Cancel()

Próbuje anulować wykonywanie elementu OleDbCommand.

Clone()

Tworzy nowy OleDbCommand obiekt, który jest kopią bieżącego wystąpienia.

CreateDbParameter()

Tworzy nowe wystąpienie DbParameter obiektu.

(Odziedziczone po DbCommand)
CreateObjRef(Type)

Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym.

(Odziedziczone po MarshalByRefObject)
CreateParameter()

Tworzy nowe wystąpienie OleDbParameter obiektu.

Dispose()

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

(Odziedziczone po DbCommand)
Dispose()

Zwalnia wszelkie zasoby używane przez element Component.

(Odziedziczone po Component)
Dispose(Boolean)

Zwalnia zasoby niezarządzane używane przez element DbCommand i opcjonalnie zwalnia zasoby zarządzane.

(Odziedziczone po DbCommand)
Dispose(Boolean)

Zwalnia zasoby niezarządzane używane przez element Component i opcjonalnie zwalnia zasoby zarządzane.

(Odziedziczone po Component)
DisposeAsync()

Asynchronicznie modyfikuje obiekt polecenia.

(Odziedziczone po DbCommand)
Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
ExecuteDbDataReader(CommandBehavior)

Wykonuje polecenie względem jego połączenia, zwracając element DbDataReader , który może służyć do uzyskiwania dostępu do wyników.

(Odziedziczone po DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

Dostawcy powinni zaimplementować tę metodę, aby zapewnić implementację nie domyślną dla ExecuteReader przeciążeń.

Domyślna implementacja wywołuje metodę synchroniczną ExecuteReader() i zwraca ukończone zadanie, blokując wątek wywołujący. Domyślna implementacja zwróci anulowane zadanie, jeśli przekazano już anulowany token anulowania. Wyjątki zgłaszane przez element ExecuteReader będą przekazywane za pośrednictwem zwróconej właściwości Wyjątek zadania.

Ta metoda akceptuje token anulowania, który może służyć do żądania wcześniejszego anulowania operacji. Implementacje mogą ignorować to żądanie.

(Odziedziczone po DbCommand)
ExecuteNonQuery()

Wykonuje instrukcję SQL względem elementu Connection i zwraca liczbę wierszy, których dotyczy problem.

ExecuteNonQueryAsync()

Asynchroniczna wersja elementu ExecuteNonQuery(), która wykonuje polecenie względem jego obiektu połączenia, zwracając liczbę wierszy, których dotyczy problem.

ExecuteNonQueryAsync(CancellationToken) Wywołuje element z elementem CancellationToken.None.

(Odziedziczone po DbCommand)
ExecuteNonQueryAsync(CancellationToken)

Jest to asynchroniczna wersja programu ExecuteNonQuery(). Dostawcy powinni zastąpić odpowiednią implementacją. Token anulowania może być opcjonalnie ignorowany.

Domyślna implementacja wywołuje metodę synchroniczną ExecuteNonQuery() i zwraca ukończone zadanie, blokując wątek wywołujący. Domyślna implementacja zwróci anulowane zadanie, jeśli przekazano już anulowany token anulowania. Wyjątki zgłaszane przez ExecuteNonQuery() program będą przekazywane za pośrednictwem zwróconej właściwości Wyjątek zadania.

Nie należy wywoływać innych metod i właściwości DbCommand obiektu, dopóki zwrócone zadanie nie zostanie ukończone.

(Odziedziczone po DbCommand)
ExecuteReader()

Wysyła element CommandText do elementu Connection i tworzy element OleDbDataReader.

ExecuteReader(CommandBehavior)

Wysyła element CommandText do elementu Connectioni tworzy obiekt OleDbDataReader przy użyciu jednej z CommandBehavior wartości.

ExecuteReaderAsync()

Asynchroniczna wersja programu ExecuteReader, która wykonuje polecenie względem jego połączenia, zwracając element DbDataReader , który może służyć do uzyskiwania dostępu do wyników.

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) Wywołuje element z elementem CancellationToken.None.

(Odziedziczone po DbCommand)
ExecuteReaderAsync(CancellationToken)

Asynchroniczna wersja programu ExecuteReader, która wykonuje polecenie względem jego połączenia, zwracając element DbDataReader , który może służyć do uzyskiwania dostępu do wyników.

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Wywołuje polecenie .

(Odziedziczone po DbCommand)
ExecuteReaderAsync(CommandBehavior)

Asynchroniczna wersja programu ExecuteReader, która wykonuje polecenie względem jego połączenia, zwracając element DbDataReader , który może służyć do uzyskiwania dostępu do wyników.

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Wywołuje polecenie .

(Odziedziczone po DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Wywołuje polecenie .

(Odziedziczone po DbCommand)
ExecuteScalar()

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

ExecuteScalarAsync()

Asynchroniczna wersja elementu ExecuteScalar(), która wykonuje polecenie i zwraca pierwszą kolumnę pierwszego wiersza w pierwszym zwróconym zestawie wyników. Wszystkie inne kolumny, wiersze i zestawy wyników są ignorowane.

ExecuteScalarAsync(CancellationToken) Wywołuje element z elementem CancellationToken.None.

(Odziedziczone po DbCommand)
ExecuteScalarAsync(CancellationToken)

Jest to asynchroniczna wersja programu ExecuteScalar(). Dostawcy powinni zastąpić odpowiednią implementacją. Token anulowania może być opcjonalnie ignorowany.

Domyślna implementacja wywołuje metodę synchroniczną ExecuteScalar() i zwraca ukończone zadanie, blokując wątek wywołujący. Domyślna implementacja zwróci anulowane zadanie, jeśli przekazano już anulowany token anulowania. Wyjątki zgłaszane przez element ExecuteScalar będą przekazywane za pośrednictwem zwróconej właściwości Wyjątek zadania.

Nie należy wywoływać innych metod i właściwości DbCommand obiektu, dopóki zwrócone zadanie nie zostanie ukończone.

(Odziedziczone po DbCommand)
GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetLifetimeService()
Przestarzałe.

Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia.

(Odziedziczone po MarshalByRefObject)
GetService(Type)

Zwraca obiekt, który reprezentuje usługę dostarczaną przez Component obiekt lub przez element Container.

(Odziedziczone po Component)
GetType()

Type Pobiera wartość bieżącego wystąpienia.

(Odziedziczone po Object)
InitializeLifetimeService()
Przestarzałe.

Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia.

(Odziedziczone po MarshalByRefObject)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
MemberwiseClone(Boolean)

Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu.

(Odziedziczone po MarshalByRefObject)
Prepare()

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

PrepareAsync(CancellationToken)

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

(Odziedziczone po DbCommand)
ResetCommandTimeout()

Resetuje CommandTimeout właściwość do wartości domyślnej.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)
ToString()

Zwraca wartość String zawierającą nazwę Componentobiektu , jeśli istnieje. Ta metoda nie powinna być zastępowana.

(Odziedziczone po Component)

Zdarzenia

Disposed

Występuje, gdy składnik jest usuwany przez wywołanie Dispose() metody .

(Odziedziczone po Component)

Jawne implementacje interfejsu

ICloneable.Clone()

Aby uzyskać opis tego członka, zobacz Clone().

IDbCommand.Connection

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

(Odziedziczone po DbCommand)
IDbCommand.CreateParameter()

Ten interfejs API obsługuje infrastrukturę produktu i nie jest przeznaczony do użycia bezpośrednio z poziomu kodu.

Tworzy nowe wystąpienie IDbDataParameter obiektu.

IDbCommand.CreateParameter()

Tworzy nowe wystąpienie IDbDataParameter obiektu.

(Odziedziczone po DbCommand)
IDbCommand.ExecuteReader()

Aby uzyskać opis tego członka, zobacz ExecuteReader().

IDbCommand.ExecuteReader(CommandBehavior)

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

IDbCommand.Parameters

Pobiera klasę IDataParameterCollection.

(Odziedziczone po DbCommand)
IDbCommand.Transaction

Pobiera lub ustawia obiekt DbTransaction , w którym jest wykonywany ten DbCommand obiekt.

(Odziedziczone po DbCommand)

Dotyczy

Zobacz też