OleDbCommand Klasa

Definicja

Przestrzeń nazw:

System.Data.OleDb

Zestaw:

System.Data.OleDb.dll

Pakiet:

System.Data.OleDb v11.0.0-preview.2.26159.112

Ź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

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")]
public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable, IDisposable

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")>]
type OleDbCommand = class
    inherit DbCommand
    interface IDbCommand
    interface IDisposable
    interface ICloneable

Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable, IDisposable

Dziedziczenie

Object

DbCommand

OleDbCommand

Atrybuty

RequiresDynamicCodeAttribute

Implementuje

IDbCommand ICloneable IDisposable

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. Następnie zostanie zwrócony wypełniony DataSet . Przykład jest przekazywany zainicjowany DataSet, parametry połączenia, parametry 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 właściwości odczytu/zapisu są ustawione na ich wartości początkowe. Aby uzyskać listę tych wartości, zobacz konstruktor OleDbCommand.

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

Przedmiot	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 agregowaną wartość z bazy danych.

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

Jeśli krytyczny OleDbException (na przykład poziom ważności programu SQL Server o wartości 20 lub większej) 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

Nazwa	Opis
OleDbCommand()	Inicjuje nowe wystąpienie klasy OleDbCommand.
OleDbCommand(String, OleDbConnection, OleDbTransaction)	Inicjuje nowe wystąpienie OleDbCommand klasy przy użyciu tekstu zapytania , OleDbConnectioni Transaction.
OleDbCommand(String, OleDbConnection)	Inicjuje nowe wystąpienie OleDbCommand klasy przy użyciu tekstu zapytania i .OleDbConnection
OleDbCommand(String)	Inicjuje nowe wystąpienie OleDbCommand klasy tekstem zapytania.

Właściwości

Nazwa	Opis
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 CommandText interpretowania właściwości.
Connection	Pobiera lub ustawia OleDbConnection wartość używaną przez to wystąpienie klasy OleDbCommand.
DesignTimeVisible	Pobiera lub ustawia wartość wskazującą, czy obiekt polecenia powinien być widoczny w dostosowanej kontrolce Programu Windows Forms Designer.
Parameters	Pobiera klasę OleDbParameterCollection.
Transaction	Pobiera lub ustawia element OleDbTransaction , w którym OleDbCommand jest wykonywany.
UpdatedRowSource	Pobiera lub ustawia sposób stosowania wyników poleceń do DataRow metody , gdy są używane przez Update metodę OleDbDataAdapter.

Metody

Nazwa	Opis
Cancel()	Próbuje anulować wykonanie elementu OleDbCommand.
Clone()	Tworzy nowy OleDbCommand obiekt, który jest kopią bieżącego wystąpienia.
CreateParameter()	Tworzy nowe wystąpienie OleDbParameter obiektu.
ExecuteNonQuery()	Wykonuje instrukcję SQL względem Connection obiektu i zwraca liczbę wierszy, których dotyczy problem.
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.
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.
ResetCommandTimeout()	Resetuje CommandTimeout właściwość do wartości domyślnej.

Jawne implementacje interfejsu

Nazwa	Opis
ICloneable.Clone()	Aby uzyskać opis tego elementu członkowskiego, zobacz Clone().
IDbCommand.ExecuteReader()	Aby uzyskać opis tego elementu członkowskiego, zobacz ExecuteReader().
IDbCommand.ExecuteReader(CommandBehavior)	Wykonuje element CommandText względem Connectionelementu i tworzy obiekt IDataReader przy użyciu jednej z CommandBehavior wartości.

Zobacz też

• OleDbDataAdapter
• OleDbConnection
• Praca z poleceniami