OdbcCommand Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Reprezentuje instrukcję SQL lub procedurę składowaną do wykonania względem źródła danych. Klasa ta nie może być dziedziczona.
public ref class OdbcCommand sealed : System::Data::Common::DbCommand, ICloneable
public ref class OdbcCommand sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbCommand
public sealed class OdbcCommand : System.Data.Common.DbCommand, ICloneable
public sealed class OdbcCommand : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbCommand
type OdbcCommand = class
inherit DbCommand
interface ICloneable
type OdbcCommand = class
inherit Component
interface ICloneable
interface IDbCommand
interface IDisposable
Public NotInheritable Class OdbcCommand
Inherits DbCommand
Implements ICloneable
Public NotInheritable Class OdbcCommand
Inherits Component
Implements ICloneable, IDbCommand, IDisposable
- Dziedziczenie
- Dziedziczenie
- Implementuje
Przykłady
W poniższym przykładzie użyto metody 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:
Element | 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 zagregowaną wartość, z bazy danych. |
Możesz zresetować CommandText właściwość i ponownie użyć OdbcCommand obiektu. Należy jednak zamknąć przed OdbcDataReader wykonaniem nowego lub poprzedniego polecenia.
Jeśli wykonanie polecenia powoduje błąd krytycznyOdbcException, taki jak poziom ważności 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 OdbcCommand nowe wystąpienie klasy z tekstem zapytania. |
OdbcCommand(String, OdbcConnection) |
Inicjuje nowe wystąpienie OdbcCommand klasy z tekstem zapytania i obiektem OdbcConnection . |
OdbcCommand(String, OdbcConnection, OdbcTransaction) |
Inicjuje nowe wystąpienie OdbcCommand klasy z 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 wygenerowania błędu. |
CommandType |
Pobiera lub ustawia wartość wskazującą sposób CommandText interpretowania właściwości. |
Connection |
Pobiera lub ustawia OdbcConnection wartość używaną przez to wystąpienie klasy OdbcCommand. |
Container |
Pobiera element IContainer zawierający element Component. (Odziedziczone po Component) |
DbConnection |
Pobiera lub ustawia wartość używaną DbConnection przez ten DbCommandelement . (Odziedziczone po DbCommand) |
DbParameterCollection |
Pobiera kolekcję DbParameter obiektów. (Odziedziczone po DbCommand) |
DbTransaction |
Pobiera lub ustawia DbTransaction obiekt, 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 interfejsu. |
Events |
Pobiera listę programów obsługi zdarzeń dołączonych do tego Componentelementu . (Odziedziczone po Component) |
Parameters |
Pobiera klasę OdbcParameterCollection. |
Site |
Pobiera lub ustawia ISite element .Component (Odziedziczone po Component) |
Transaction |
Pobiera lub ustawia OdbcTransaction element, w którym OdbcCommand są wykonywane. |
UpdatedRowSource |
Pobiera lub ustawia wartość określającą sposób zastosowania wyników polecenia metody Update do elementu DataRow. |
Metody
Cancel() |
Próbuje anulować wykonywanie elementu OdbcCommand. |
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 OdbcParameter 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 dysponuje 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 połączenia, zwracając DbDataReader element, 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ę w celu zapewnienia nie domyślnej implementacji 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ątku 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 programu ExecuteNonQuery(), która wykonuje polecenie względem obiektu połączenia, zwracając liczbę wierszy, których dotyczy problem. ExecuteNonQueryAsync(CancellationToken) Wywołuje element 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łoszone przez ExecuteNonQuery() program będą przekazywane za pośrednictwem zwróconej właściwości Wyjątki zadania. Nie należy wywoływać innych metod i właściwości |
ExecuteReader() |
Wysyła element CommandText do elementu Connection i tworzy element OdbcDataReader. |
ExecuteReader(CommandBehavior) |
Wysyła element CommandText do obiektu Connectioni tworzy element OdbcDataReader przy użyciu jednej z |
ExecuteReaderAsync() |
Asynchroniczna wersja programu ExecuteReader, która wykonuje polecenie względem 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 CancellationToken.None. (Odziedziczone po DbCommand) |
ExecuteReaderAsync(CancellationToken) |
Asynchroniczna wersja programu ExecuteReader, która wykonuje polecenie względem 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 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 ExecuteScalar()elementu , 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 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ątku zadania. Nie należy wywoływać innych metod i właściwości |
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 obiekt lub przez obiekt Container. (Odziedziczone po Component) |
GetType() |
Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object) |
InitializeLifetimeService() |
Przestarzałe.
Uzyskuje obiekt usługi okresu istnienia, aby kontrolować zasady 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 wersja 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 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 elementu członkowskiego, zobacz Clone(). |
IDbCommand.Connection |
Pobiera lub ustawia IDbConnection wartość używaną przez to wystąpienie klasy IDbCommand. (Odziedziczone po DbCommand) |
IDbCommand.CreateParameter() |
Tworzy nowe wystąpienie IDbDataParameter obiektu. |
IDbCommand.CreateParameter() |
Tworzy nowe wystąpienie IDbDataParameter obiektu. (Odziedziczone po DbCommand) |
IDbCommand.ExecuteReader() |
Ten interfejs API obsługuje infrastrukturę produktu i nie jest przeznaczony do użycia bezpośrednio z poziomu kodu. Wykonuje element CommandText względem elementu Connection i tworzy element IDataReader. |
IDbCommand.ExecuteReader() |
Wykonuje element CommandText względem elementu Connection i tworzy element IDataReader. (Odziedziczone po DbCommand) |
IDbCommand.ExecuteReader(CommandBehavior) |
Ten interfejs API obsługuje infrastrukturę produktu i nie jest przeznaczony do użycia bezpośrednio z poziomu kodu. Wykonuje element CommandText względem elementu Connectioni tworzy IDataReader element przy użyciu określonego zachowania. |
IDbCommand.ExecuteReader(CommandBehavior) |
Wykonuje element CommandText względem elementu Connectioni tworzy element IDataReader przy użyciu jednej z CommandBehavior wartości. (Odziedziczone po DbCommand) |
IDbCommand.Parameters |
Pobiera klasę IDataParameterCollection. (Odziedziczone po DbCommand) |
IDbCommand.Transaction |
Pobiera lub ustawia DbTransaction obiekt, w którym jest wykonywany ten DbCommand obiekt. (Odziedziczone po DbCommand) |
Metody rozszerzania
ConfigureAwait(IAsyncDisposable, Boolean) |
Konfiguruje sposób oczekiwania na zadania zwracane z jednorazowego użytku asynchronicznego. |
Dotyczy
Zobacz też
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla