OleDbCommand Klasa

Definicja

Przestrzeń nazw:

System.Data.OleDb

Zestaw:

System.Data.OleDb.dll

Pakiet:

System.Data.OleDb v9.0.0-rc.1.24431.7

Źródło:

OleDbCommand.cs

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, IDisposable

public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable, IDisposable

type OleDbCommand = class
    inherit DbCommand
    interface IDbCommand
    interface IDisposable
    interface ICloneable

Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable, IDisposable

Dziedziczenie

Object

MarshalByRefObject

Component

DbCommand

OleDbCommand

Implementuje

IDbCommand ICloneable IDisposable

Przykłady

W poniższym przykładzie użyto OleDbCommand, wzdłuż OleDbDataAdapter i OleDbConnection, aby wybrać wiersze z bazy danych programu Access. Następnie zostanie zwrócony wypełniony DataSet. Przykład jest przekazywany zainicjowany DataSet, parametry połączenia, parametry zapytania, które są 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 wystąpienia OleDbCommand właściwości odczytu/zapisu są ustawione na ich wartości początkowe. Aby uzyskać listę tych wartości, zobacz konstruktor OleDbCommand.

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

Przedmiot	Opis
ExecuteReader	Wykonuje polecenia zwracające wiersze. ExecuteReader może nie mieć wpływu, 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 agregowaną wartość z bazy danych.

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

Jeśli OleDbException krytycznym (na przykład poziom ważności programu SQL Server o wartości 20 lub większej) jest generowany przez metodę wykonującą 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 nowe wystąpienie klasy OleDbCommand tekstem zapytania.
OleDbCommand(String, OleDbConnection)	Inicjuje nowe wystąpienie klasy OleDbCommand tekstem zapytania i OleDbConnection.
OleDbCommand(String, OleDbConnection, OleDbTransaction)	Inicjuje nowe wystąpienie klasy OleDbCommand tekstem 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 wygenerowaniem błędu.
CommandType	Pobiera lub ustawia wartość wskazującą sposób interpretowania właściwości CommandText.
Connection	Pobiera lub ustawia OleDbConnection używane przez to wystąpienie OleDbCommand.
Container	Pobiera IContainer, który zawiera Component. (Odziedziczone po Component)
DbConnection	Pobiera lub ustawia DbConnection używane przez ten DbCommand. (Odziedziczone po DbCommand)
DbParameterCollection	Pobiera kolekcję obiektów DbParameter. (Odziedziczone po DbCommand)
DbTransaction	Pobiera lub ustawia DbTransaction, w którym jest wykonywany ten obiekt DbCommand. (Odziedziczone po DbCommand)
DesignMode	Pobiera wartość wskazującą, czy Component jest obecnie w trybie projektowania. (Odziedziczone po Component)
DesignTimeVisible	Pobiera lub ustawia wartość wskazującą, czy obiekt polecenia powinien być widoczny w dostosowanej kontrolce Programu Windows Forms Designer.
Events	Pobiera listę programów obsługi zdarzeń dołączonych do tej Component. (Odziedziczone po Component)
Parameters	Pobiera OleDbParameterCollection.
Site	Pobiera lub ustawia ISiteComponent. (Odziedziczone po Component)
Transaction	Pobiera lub ustawia OleDbTransaction, w ramach którego jest wykonywana OleDbCommand.
UpdatedRowSource	Pobiera lub ustawia sposób stosowania wyników poleceń do DataRow w przypadku użycia przez metodę UpdateOleDbDataAdapter.

Metody

Cancel()	Próbuje anulować wykonywanie OleDbCommand.
Clone()	Tworzy nowy obiekt OleDbCommand, który jest kopią bieżącego wystąpienia.
CreateDbParameter()	Tworzy nowe wystąpienie obiektu DbParameter. (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 obiektu OleDbParameter.
Dispose()	Wykonuje zadania zdefiniowane przez aplikację skojarzone z zwalnianiem, wydawaniem lub resetowaniem niezarządzanych zasobów. (Odziedziczone po DbCommand)
Dispose(Boolean)	Zwalnia niezarządzane zasoby używane przez DbCommand i opcjonalnie zwalnia zarządzane zasoby. (Odziedziczone po DbCommand)
DisposeAsync()	Asynchronicznie diposuje obiekt polecenia. (Odziedziczone po DbCommand)
Equals(Object)	Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object)
ExecuteDbDataReader(CommandBehavior)	Wykonuje polecenie względem jego połączenia, zwracając DbDataReader, które mogą służyć do uzyskiwania dostępu do wyników. (Odziedziczone po DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)	Dostawcy powinni zaimplementować tę metodę, aby zapewnić implementację inną niż domyślna dla przeciążeń ExecuteReader. Domyślna implementacja wywołuje synchroniczną metodę 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 Connection i zwraca liczbę wierszy, których dotyczy problem.
ExecuteNonQueryAsync()	Asynchroniczna wersja ExecuteNonQuery(), która wykonuje polecenie względem jego obiektu połączenia, zwracając liczbę wierszy, których dotyczy problem. Wywołuje ExecuteNonQueryAsync(CancellationToken) z elementem CancellationToken.None. (Odziedziczone po DbCommand)
ExecuteNonQueryAsync(CancellationToken)	Jest to asynchroniczna wersja ExecuteNonQuery(). Dostawcy powinni zastąpić odpowiednią implementacją. Token anulowania może być opcjonalnie ignorowany. Domyślna implementacja wywołuje synchroniczną metodę 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() 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 obiektu DbCommand, dopóki zwrócone zadanie nie zostanie ukończone. (Odziedziczone po DbCommand)
ExecuteReader()	Wysyła CommandText do Connection i tworzy OleDbDataReader.
ExecuteReader(CommandBehavior)	Wysyła CommandText do Connectioni tworzy OleDbDataReader przy użyciu jednej z wartości CommandBehavior.
ExecuteReaderAsync()	Asynchroniczna wersja ExecuteReader, która wykonuje polecenie względem jego połączenia, zwracając DbDataReader, który może służyć do uzyskiwania dostępu do wyników. Wywołuje ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) z elementem CancellationToken.None. (Odziedziczone po DbCommand)
ExecuteReaderAsync(CancellationToken)	Asynchroniczna wersja ExecuteReader, która wykonuje polecenie względem jego połączenia, zwracając DbDataReader, który może służyć do uzyskiwania dostępu do wyników. Wywołuje ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Odziedziczone po DbCommand)
ExecuteReaderAsync(CommandBehavior)	Asynchroniczna wersja ExecuteReader, która wykonuje polecenie względem jego połączenia, zwracając DbDataReader, który może służyć do uzyskiwania dostępu do wyników. Wywołuje ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Odziedziczone po DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Wywołuje ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (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 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. Wywołuje ExecuteScalarAsync(CancellationToken) z elementem CancellationToken.None. (Odziedziczone po DbCommand)
ExecuteScalarAsync(CancellationToken)	Jest to asynchroniczna wersja ExecuteScalar(). Dostawcy powinni zastąpić odpowiednią implementacją. Token anulowania może być opcjonalnie ignorowany. Domyślna implementacja wywołuje synchroniczną metodę 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ątku zadania. Nie należy wywoływać innych metod i właściwości obiektu DbCommand, 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 reprezentujący usługę dostarczaną przez Component lub Container. (Odziedziczone po Component)
GetType()	Pobiera Type 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 Object. (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego obiektu MarshalByRefObject. (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 właściwość CommandTimeout do wartości domyślnej.
ToString()	Zwraca String zawierającą nazwę Component, 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 metody Dispose(). (Odziedziczone po Component)

Jawne implementacje interfejsu

ICloneable.Clone()	Aby uzyskać opis tego elementu członkowskiego, zobacz Clone().
IDbCommand.Connection	Pobiera lub ustawia IDbConnection używane przez to wystąpienie IDbCommand. (Odziedziczone po DbCommand)
IDbCommand.CreateParameter()	Tworzy nowe wystąpienie obiektu IDbDataParameter. (Odziedziczone po DbCommand)
IDbCommand.ExecuteReader()	Aby uzyskać opis tego elementu członkowskiego, zobacz ExecuteReader().
IDbCommand.ExecuteReader(CommandBehavior)	Wykonuje CommandText względem Connectioni tworzy IDataReader przy użyciu jednej z wartości CommandBehavior.
IDbCommand.Parameters	Pobiera IDataParameterCollection. (Odziedziczone po DbCommand)
IDbCommand.Transaction	Pobiera lub ustawia DbTransaction, w którym jest wykonywany ten obiekt DbCommand. (Odziedziczone po DbCommand)

Metody rozszerzania

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguruje, w jaki sposób będą wykonywane oczekiwania na zadania zwrócone z asynchronicznego jednorazowego użytku.

Zobacz też

• OleDbDataAdapter
• OleDbConnection
• praca z poleceniami