OdbcCommand Klasa

Definicja

Przestrzeń nazw:

System.Data.Odbc

Zestaw:

System.Data.Odbc.dll

Pakiet:

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

Źródło:

OdbcCommand.cs

Reprezentuje instrukcję SQL lub procedurę składowaną do wykonania względem źródła danych. Tej klasy nie można dziedziczyć.

public ref class OdbcCommand sealed : System::Data::Common::DbCommand, ICloneable

public sealed class OdbcCommand : System.Data.Common.DbCommand, ICloneable

type OdbcCommand = class
    inherit DbCommand
    interface ICloneable

Public NotInheritable Class OdbcCommand
Inherits DbCommand
Implements ICloneable

Dziedziczenie

Object

MarshalByRefObject

Component

DbCommand

OdbcCommand

Implementuje

ICloneable

Przykłady

W poniższym przykładzie użyto ExecuteNonQuery.

public void InsertRow(string connectionString, string insertSQL)
{
    using (OdbcConnection connection =
               new OdbcConnection(connectionString))
    {
        // The insertSQL string contains a SQL statement that
        // inserts a new row in the source table.
        OdbcCommand command = new OdbcCommand(insertSQL, connection);

        // Open the connection and execute the insert command.
        try
        {
            connection.Open();
            command.ExecuteNonQuery();
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }

Public Sub InsertRow(ByVal connectionString As String, _
    ByVal insertSQL As String)

    Using connection As New OdbcConnection(connectionString)
        ' The insertSQL string contains a SQL statement that
        ' inserts a new row in the source table.
        Dim command As New OdbcCommand(insertSQL, connection)

        ' Open the connection and execute the insert command.
        Try
            connection.Open()
            command.ExecuteNonQuery()
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
        ' The connection is automatically closed when the
        ' code exits the Using block.
    End Using
End Sub

Uwagi

Klasa OdbcCommand udostępnia następujące metody wykonywania poleceń względem źródła danych:

Przedmiot	Opis
ExecuteReader	Wykonuje polecenia zwracające wiersze.
ExecuteNonQuery	Wykonuje polecenia, takie jak INSTRUKCJe SQL INSERT, DELETE, UPDATE i SET.
ExecuteScalar	Pobiera pojedynczą wartość, na przykład wartość agregowaną, z bazy danych.

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

Jeśli wykonanie polecenia powoduje OdbcException krytycznych, takich jak poziom ważności programu SQL Server 20 lub więcej, OdbcConnection może zostać zamknięty. Użytkownik może jednak ponownie otworzyć połączenie i kontynuować.

Konstruktory

OdbcCommand()	Inicjuje nowe wystąpienie klasy OdbcCommand.
OdbcCommand(String)	Inicjuje nowe wystąpienie klasy OdbcCommand tekstem zapytania.
OdbcCommand(String, OdbcConnection)	Inicjuje nowe wystąpienie klasy OdbcCommand tekstem zapytania i obiektem OdbcConnection.
OdbcCommand(String, OdbcConnection, OdbcTransaction)	Inicjuje nowe wystąpienie klasy OdbcCommand tekstem zapytania, obiektem OdbcConnection i 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 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	Pobiera lub ustawia wartość wskazującą sposób interpretowania właściwości CommandText.
Connection	Pobiera lub ustawia OdbcConnection używane przez to wystąpienie OdbcCommand.
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 interfejsu.
Events	Pobiera listę programów obsługi zdarzeń dołączonych do tej Component. (Odziedziczone po Component)
Parameters	Pobiera OdbcParameterCollection.
Site	Pobiera lub ustawia ISiteComponent. (Odziedziczone po Component)
Transaction	Pobiera lub ustawia OdbcTransaction, w ramach którego jest wykonywana OdbcCommand.
UpdatedRowSource	Pobiera lub ustawia wartość określającą, w jaki sposób metoda Update powinna stosować wyniki polecenia do DataRow.

Metody

Cancel()	Próbuje anulować wykonywanie OdbcCommand.
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 OdbcParameter.
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 OdbcDataReader.
ExecuteReader(CommandBehavior)	Wysyła CommandText do Connectioni tworzy OdbcDataReader 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()	Wykonuje CommandText względem Connection i tworzy IDataReader. (Odziedziczone po DbCommand)
IDbCommand.ExecuteReader(CommandBehavior)	Wykonuje CommandText względem Connectioni tworzy IDataReader przy użyciu jednej z wartości CommandBehavior. (Odziedziczone po DbCommand)
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ż

• OdbcDataAdapter
• OdbcConnection
• wykonywanie poleceń