OleDbCommand Klasa

Definicja

Reprezentuje instrukcję SQL lub procedurę składowaną, która ma zostać wykonana względem źródła danych.Represents an SQL statement or stored procedure to execute against a data source.

public ref class OleDbCommand sealed : System::Data::Common::DbCommand, ICloneable
public ref class OleDbCommand sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbCommand
public ref class OleDbCommand sealed : System::Data::Common::DbCommand, ICloneable, IDisposable
public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable
public sealed class OleDbCommand : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbCommand
public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable, IDisposable
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 Component
Implements ICloneable, IDbCommand, IDisposable
Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable, IDisposable
Dziedziczenie
OleDbCommand
Dziedziczenie
Dziedziczenie
Implementuje

Przykłady

Poniższy przykład używa OleDbCommand, wzdłuż OleDbDataAdapter i OleDbConnection, aby wybrać wiersze z bazy danych programu Access.The following example uses the OleDbCommand, along OleDbDataAdapter and OleDbConnection, to select rows from an Access database. Zostanie zwrócona DataSet wypełnionej.The filled DataSet is then returned. W przykładzie przeszedł zainicjowany DataSet, ciąg połączenia, ciąg zapytania, który jest instrukcją SELECT języka SQL, oraz ciąg, który jest nazwą źródłowej tabeli bazy danych.The example is passed an initialized DataSet, a connection string, a query string that is an SQL SELECT statement, and a string that is the name of the source database table.

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 do odczytu/zapisu są ustawiane na wartości początkowe.When an instance of OleDbCommand is created, the read/write properties are set to their initial values. Aby uzyskać listę tych wartości, zobacz Konstruktor OleDbCommand.For a list of these values, see the OleDbCommand constructor.

OleDbCommand funkcje wykonujące polecenia w źródle danych:OleDbCommand features the following methods executing commands at a data source:

ElementItem OpisDescription
ExecuteReader Wykonuje polecenia, które zwracają wiersze.Executes commands that return rows. ExecuteReader może nie mieć efektu, który ma być używany do wykonywania poleceń, takich jak instrukcje SQL SET.ExecuteReader may not have the effect that you want if used to execute commands such as SQL SET statements.
ExecuteNonQuery Wykonuje polecenia, takie jak instrukcje SQL INSERT, DELETE, UPDATE i SET.Executes commands such as SQL INSERT, DELETE, UPDATE, and SET statements.
ExecuteScalar Pobiera pojedynczą wartość, na przykład wartość zagregowaną z bazy danych.Retrieves a single value, for example, an aggregate value from a database.

Możesz zresetować Właściwość CommandText i ponownie użyć obiektu OleDbCommand.You can reset the CommandText property and reuse the OleDbCommand object. Należy jednak zamknąć OleDbDataReader, aby można było wykonać nowe lub poprzednie polecenie.However, you must close the OleDbDataReader before you can execute a new or previous command.

Jeśli OleDbException krytyczny (na przykład poziom ważności SQL Server 20 lub większy) jest generowany przez metodę wykonującą OleDbCommand, OleDbConnection, połączenie może być zamknięte.If a fatal OleDbException (for example, a SQL Server severity level of 20 or greater) is generated by the method executing an OleDbCommand, the OleDbConnection, the connection may be closed. Użytkownik może jednak ponownie otworzyć połączenie i kontynuować pracę.However, the user can reopen the connection and continue.

Konstruktory

OleDbCommand()

Inicjuje nowe wystąpienie klasy OleDbCommand.Initializes a new instance of the OleDbCommand class.

OleDbCommand(String)

Inicjuje nowe wystąpienie klasy OleDbCommand z tekstem zapytania.Initializes a new instance of the OleDbCommand class with the text of the query.

OleDbCommand(String, OleDbConnection)

Inicjuje nowe wystąpienie klasy OleDbCommand z tekstem zapytania i OleDbConnection.Initializes a new instance of the OleDbCommand class with the text of the query and an OleDbConnection.

OleDbCommand(String, OleDbConnection, OleDbTransaction)

Inicjuje nowe wystąpienie klasy OleDbCommand z tekstem zapytania, OleDbConnectioni Transaction.Initializes a new instance of the OleDbCommand class with the text of the query, an OleDbConnection, and the Transaction.

Właściwości

CanRaiseEvents

Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie.Gets a value indicating whether the component can raise an event.

(Odziedziczone po Component)
CommandText

Pobiera lub ustawia instrukcję SQL lub procedurę przechowywaną do wykonania w źródle danych.Gets or sets the SQL statement or stored procedure to execute at the data source.

CommandTimeout

Pobiera lub ustawia czas oczekiwania (w sekundach) przed zakończeniem próby wykonania polecenia i wygenerowaniem błędu.Gets or sets the wait time (in seconds) before terminating an attempt to execute a command and generating an error.

CommandType

Pobiera lub ustawia wartość wskazującą sposób interpretacji właściwości CommandText.Gets or sets a value that indicates how the CommandText property is interpreted.

Connection

Pobiera lub ustawia OleDbConnection używany przez to wystąpienie OleDbCommand.Gets or sets the OleDbConnection used by this instance of the OleDbCommand.

Container

Pobiera IContainer, który zawiera Component.Gets the IContainer that contains the Component.

(Odziedziczone po Component)
DbConnection

Gdy jest zastępowany w klasie pochodnej, Pobiera lub ustawia DbConnection używany przez ten DbCommand.When overridden in a derived class, gets or sets the DbConnection used by this DbCommand.

(Odziedziczone po DbCommand)
DbParameterCollection

Gdy jest zastępowany w klasie pochodnej, pobiera kolekcję obiektów DbParameter.When overridden in a derived class, gets the collection of DbParameter objects.

(Odziedziczone po DbCommand)
DbTransaction

Gdy jest zastępowany w klasie pochodnej, Pobiera lub ustawia DbTransaction, w których jest wykonywany ten obiekt DbCommand.When overridden in a derived class, gets or sets the DbTransaction within which this DbCommand object executes.

(Odziedziczone po DbCommand)
DesignMode

Pobiera wartość wskazującą, czy Component jest obecnie w trybie projektowania.Gets a value that indicates whether the Component is currently in design mode.

(Odziedziczone po Component)
DesignTimeVisible

Pobiera lub ustawia wartość wskazującą, czy obiekt polecenia powinien być widoczny w dostosowanym formancie Projektant formularzy systemu Windows.Gets or sets a value that indicates whether the command object should be visible in a customized Windows Forms Designer control.

Events

Pobiera listę programów obsługi zdarzeń, które są dołączone do tego Component.Gets the list of event handlers that are attached to this Component.

(Odziedziczone po Component)
Parameters

Pobiera klasę OleDbParameterCollection.Gets the OleDbParameterCollection.

Site

Pobiera lub ustawia ISite Component.Gets or sets the ISite of the Component.

(Odziedziczone po Component)
Transaction

Pobiera lub ustawia OleDbTransaction, w ramach którego OleDbCommand wykonuje.Gets or sets the OleDbTransaction within which the OleDbCommand executes.

UpdatedRowSource

Pobiera lub ustawia sposób, w jaki wyniki poleceń są stosowane do DataRow, gdy są używane przez metodę Update OleDbDataAdapter.Gets or sets how command results are applied to the DataRow when used by the Update method of the OleDbDataAdapter.

Metody

Cancel()

Próbuje anulować wykonanie OleDbCommand.Tries to cancel the execution of an OleDbCommand.

Clone()

Tworzy nowy obiekt OleDbCommand, który jest kopią bieżącego wystąpienia.Creates a new OleDbCommand object that is a copy of the current instance.

CreateDbParameter()

Gdy jest zastępowany w klasie pochodnej, tworzy nowe wystąpienie obiektu DbParameter.When overridden in a derived class, creates a new instance of a DbParameter object.

(Odziedziczone po DbCommand)
CreateObjRef(Type)

Tworzy obiekt, który zawiera wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikacji z obiektem zdalnym.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Odziedziczone po MarshalByRefObject)
CreateParameter()

Tworzy nowe wystąpienie obiektu OleDbParameter.Creates a new instance of an OleDbParameter object.

Dispose() (Odziedziczone po DbCommand)
Dispose()

Zwalnia wszelkie zasoby używane przez element Component.Releases all resources used by the Component.

(Odziedziczone po Component)
Dispose(Boolean) (Odziedziczone po DbCommand)
Dispose(Boolean)

Zwalnia zasoby niezarządzane używane przez element Component i opcjonalnie zwalnia zasoby zarządzane.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Odziedziczone po Component)
DisposeAsync()

Asynchronicznie nakłada obiekt polecenia.Asynchronously diposes the command object.

(Odziedziczone po DbCommand)
Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
ExecuteDbDataReader(CommandBehavior)

Gdy jest zastępowany w klasie pochodnej, wykonuje tekst polecenia względem połączenia.When overridden in a derived class, executes the command text against the connection.

(Odziedziczone po DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

Dostawcy powinni zaimplementować tę metodę, aby zapewnić niedomyślną implementację przeciążeń ExecuteReader.Providers should implement this method to provide a non-default implementation for ExecuteReader overloads.

Implementacja domyślna wywołuje synchroniczną metodę ExecuteReader() i zwraca zadanie zakończone, blokując wątek wywołujący.The default implementation invokes the synchronous ExecuteReader() method and returns a completed task, blocking the calling thread. Domyślna implementacja zwróci anulowane zadanie, jeśli przekazał już anulowane tokeny anulowania.The default implementation will return a cancelled task if passed an already cancelled cancellation token. Wyjątki zgłoszone przez ExecuteReader będą przekazywane przy użyciu zwróconej właściwości wyjątku zadania.Exceptions thrown by ExecuteReader will be communicated via the returned Task Exception property.

Ta metoda akceptuje token anulowania, którego można użyć do żądania wcześniejszego anulowania operacji.This method accepts a cancellation token that can be used to request the operation to be cancelled early. Implementacje mogą zignorować to żądanie.Implementations may ignore this request.

(Odziedziczone po DbCommand)
ExecuteNonQuery()

Wykonuje instrukcję SQL względem Connection i zwraca liczbę wierszy, których to dotyczy.Executes an SQL statement against the Connection and returns the number of rows affected.

ExecuteNonQueryAsync()

Asynchroniczna wersja ExecuteNonQuery(), która wykonuje instrukcję SQL względem obiektu połączenia.An asynchronous version of ExecuteNonQuery(), which executes a SQL statement against a connection object.

Wywołuje ExecuteNonQueryAsync(CancellationToken) z CancellationToken. None.Invokes ExecuteNonQueryAsync(CancellationToken) with CancellationToken.None.

(Odziedziczone po DbCommand)
ExecuteNonQueryAsync(CancellationToken)

Jest to asynchroniczna wersja ExecuteNonQuery().This is the asynchronous version of ExecuteNonQuery(). Dostawcy powinny zastępować odpowiednie implementacje.Providers should override with an appropriate implementation. Token anulowania może być opcjonalnie ignorowany.The cancellation token may optionally be ignored.

Implementacja domyślna wywołuje synchroniczną metodę ExecuteNonQuery() i zwraca zadanie zakończone, blokując wątek wywołujący.The default implementation invokes the synchronous ExecuteNonQuery() method and returns a completed task, blocking the calling thread. Domyślna implementacja zwróci anulowane zadanie, jeśli przekazał już anulowane tokeny anulowania.The default implementation will return a cancelled task if passed an already cancelled cancellation token. Wyjątki zgłoszone przez ExecuteNonQuery() będą przekazywane przez zwróconą Właściwość wyjątku zadania.Exceptions thrown by ExecuteNonQuery() will be communicated via the returned Task Exception property.

Nie wywołuj innych metod i właściwości obiektu DbCommand, dopóki nie zakończy się zwrócone zadanie.Do not invoke other methods and properties of the DbCommand object until the returned Task is complete.

(Odziedziczone po DbCommand)
ExecuteReader()

Wysyła CommandText do Connection i kompiluje OleDbDataReader.Sends the CommandText to the Connection and builds an OleDbDataReader.

ExecuteReader(CommandBehavior)

Wysyła CommandText do Connectioni kompiluje OleDbDataReader przy użyciu jednej z wartości CommandBehavior.Sends the CommandText to the Connection, and builds an OleDbDataReader using one of the CommandBehavior values.

ExecuteReaderAsync()

Asynchroniczna wersja ExecuteReader, która wykonuje CommandText względem Connection i zwraca DbDataReader.An asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader.

Wywołuje ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) z CancellationToken. None.Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) with CancellationToken.None.

(Odziedziczone po DbCommand)
ExecuteReaderAsync(CancellationToken)

Asynchroniczna wersja ExecuteReader, która wykonuje CommandText względem Connection i zwraca DbDataReader.An asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader. Ta metoda propaguje powiadomienie, że operacje powinny być anulowane.This method propagates a notification that operations should be canceled.

Wywołuje ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

(Odziedziczone po DbCommand)
ExecuteReaderAsync(CommandBehavior)

Asynchroniczna wersja ExecuteReader, która wykonuje CommandText względem Connection i zwraca DbDataReader.An asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader.

Wywołuje ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

(Odziedziczone po DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)

Wywołuje ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

(Odziedziczone po DbCommand)
ExecuteScalar()

Wykonuje zapytanie i zwraca pierwszą kolumnę pierwszego wiersza w zestawie wyników zwróconym przez zapytanie.Executes the query, and returns the first column of the first row in the result set returned by the query. Dodatkowe kolumny lub wiersze są ignorowane.Additional columns or rows are ignored.

ExecuteScalarAsync()

Asynchroniczna wersja ExecuteScalar(), która wykonuje zapytanie i zwraca pierwszą kolumnę pierwszego wiersza w zestawie wyników zwróconym przez zapytanie.An asynchronous version of ExecuteScalar(), which executes the query and returns the first column of the first row in the result set returned by the query. Wszystkie inne kolumny i wiersze są ignorowane.All other columns and rows are ignored.

Wywołuje ExecuteScalarAsync(CancellationToken) z CancellationToken. None.Invokes ExecuteScalarAsync(CancellationToken) with CancellationToken.None.

(Odziedziczone po DbCommand)
ExecuteScalarAsync(CancellationToken)

Jest to asynchroniczna wersja ExecuteScalar().This is the asynchronous version of ExecuteScalar(). Dostawcy powinny zastępować odpowiednie implementacje.Providers should override with an appropriate implementation. Token anulowania może być opcjonalnie ignorowany.The cancellation token may optionally be ignored.

Implementacja domyślna wywołuje synchroniczną metodę ExecuteScalar() i zwraca zadanie zakończone, blokując wątek wywołujący.The default implementation invokes the synchronous ExecuteScalar() method and returns a completed task, blocking the calling thread. Domyślna implementacja zwróci anulowane zadanie, jeśli przekazał już anulowane tokeny anulowania.The default implementation will return a cancelled task if passed an already cancelled cancellation token. Wyjątki zgłoszone przez ExecuteScalar będą przekazywane przy użyciu zwróconej właściwości wyjątku zadania.Exceptions thrown by ExecuteScalar will be communicated via the returned Task Exception property.

Nie wywołuj innych metod i właściwości obiektu DbCommand, dopóki nie zakończy się zwrócone zadanie.Do not invoke other methods and properties of the DbCommand object until the returned Task is complete.

(Odziedziczone po DbCommand)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetLifetimeService()

Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
GetService(Type)

Zwraca obiekt, który reprezentuje usługę dostarczoną przez Component lub Container.Returns an object that represents a service provided by the Component or by its Container.

(Odziedziczone po Component)
GetType()

Pobiera Type bieżącego wystąpienia.Gets the Type of the current instance.

(Odziedziczone po Object)
InitializeLifetimeService()

Uzyskuje obiekt usługi istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
MemberwiseClone(Boolean)

Tworzy skróconą kopię bieżącego obiektu MarshalByRefObject.Creates a shallow copy of the current MarshalByRefObject object.

(Odziedziczone po MarshalByRefObject)
Prepare()

Tworzy przygotowaną (lub skompilowaną) wersję polecenia w źródle danych.Creates a prepared (or compiled) version of the command on the data source.

PrepareAsync(CancellationToken)

Asynchronicznie tworzy przygotowaną (lub skompilowaną) wersję polecenia w źródle danych.Asynchronously creates a prepared (or compiled) version of the command on the data source.

(Odziedziczone po DbCommand)
ResetCommandTimeout()

Resetuje właściwość CommandTimeout do wartości domyślnej.Resets the CommandTimeout property to the default value.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)
ToString()

Zwraca String zawierający nazwę Component, jeśli istnieje.Returns a String containing the name of the Component, if any. Ta metoda nie powinna być przesłaniana.This method should not be overridden.

(Odziedziczone po Component)

Zdarzenia

Disposed

Występuje, gdy składnik zostanie usunięty przez wywołanie metody Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Odziedziczone po Component)

Jawne implementacje interfejsu

ICloneable.Clone()

Aby uzyskać opis tego elementu członkowskiego, zobacz Clone().For a description of this member, see Clone().

IDbCommand.Connection

Pobiera lub ustawia IDbConnection używany przez to wystąpienie IDbCommand.Gets or sets the IDbConnection used by this instance of the IDbCommand.

(Odziedziczone po DbCommand)
IDbCommand.CreateParameter()

Tworzy nowe wystąpienie obiektu IDbDataParameter.Creates a new instance of an IDbDataParameter object.

IDbCommand.CreateParameter()

Tworzy nowe wystąpienie obiektu IDbDataParameter.Creates a new instance of an IDbDataParameter object.

(Odziedziczone po DbCommand)
IDbCommand.ExecuteReader()

Aby uzyskać opis tego elementu członkowskiego, zobacz ExecuteReader().For a description of this member, see ExecuteReader().

IDbCommand.ExecuteReader(CommandBehavior)

Wykonuje CommandText z Connectioni kompiluje IDataReader przy użyciu jednej z wartości CommandBehavior.Executes the CommandText against the Connection, and builds an IDataReader using one of the CommandBehavior values.

IDbCommand.Parameters

Pobiera klasę IDataParameterCollection.Gets the IDataParameterCollection.

(Odziedziczone po DbCommand)
IDbCommand.Transaction

Pobiera lub ustawia DbTransaction, w którym jest wykonywany ten obiekt DbCommand.Gets or sets the DbTransaction within which this DbCommand object executes.

(Odziedziczone po DbCommand)

Dotyczy

Zobacz też