OleDbCommand Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Představuje příkaz SQL nebo uloženou proceduru, která se má provést ve zdroji dat.
public ref class OleDbCommand sealed : System::Data::Common::DbCommand, ICloneable, IDisposable
public ref class OleDbCommand sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbCommand
public ref class OleDbCommand sealed : System::Data::Common::DbCommand, ICloneable
public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable, IDisposable
public sealed class OleDbCommand : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbCommand
public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable
type OleDbCommand = class
inherit DbCommand
interface ICloneable
interface IDbCommand
interface IDisposable
type OleDbCommand = class
inherit Component
interface ICloneable
interface IDbCommand
interface IDisposable
type OleDbCommand = class
inherit DbCommand
interface IDbCommand
interface IDisposable
interface ICloneable
Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable, IDisposable
Public NotInheritable Class OleDbCommand
Inherits Component
Implements ICloneable, IDbCommand, IDisposable
Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable
- Dědičnost
- Dědičnost
- Implementuje
Příklady
Následující příklad používá OleDbCommand, podél OleDbDataAdapter a OleDbConnection, k výběru řádků z accessové databáze. Potom se vrátí vyplněný DataSet. Příklad se předá inicializovaný DataSet, připojovací řetězec, řetězec dotazu, který je příkazem SQL SELECT, a řetězec, který je názvem zdrojové tabulky databáze.
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
Poznámky
Při vytvoření instance OleDbCommand jsou vlastnosti pro čtení a zápis nastaveny na jejich počáteční hodnoty. Seznam těchto hodnot najdete v OleDbCommand konstruktoru.
OleDbCommand nabízí následující metody, které spouští příkazy ve zdroji dat:
Položka | Popis |
---|---|
ExecuteReader | Spustí příkazy, které vracejí řádky. ExecuteReader nemusí mít vliv, který chcete použít ke spouštění příkazů, jako jsou příkazy SQL SET. |
ExecuteNonQuery | Spouští příkazy, jako jsou příkazy SQL INSERT, DELETE, UPDATE a SET. |
ExecuteScalar | Načte jednu hodnotu, například agregační hodnotu z databáze. |
Vlastnost CommandText můžete obnovit a znovu použít objekt OleDbCommand. Před spuštěním nového nebo předchozího příkazu však musíte OleDbDataReader zavřít.
Pokud je závažná OleDbException (například úroveň závažnosti SQL Serveru 20 nebo vyšší) vygenerována metodou, která spouští OleDbCommand, může být připojení uzavřeno OleDbConnection. Uživatel ale může znovu otevřít připojení a pokračovat.
Konstruktory
OleDbCommand() |
Inicializuje novou instanci OleDbCommand třídy. |
OleDbCommand(String) |
Inicializuje novou instanci třídy OleDbCommand textem dotazu. |
OleDbCommand(String, OleDbConnection) |
Inicializuje novou instanci třídy OleDbCommand s textem dotazu a OleDbConnection. |
OleDbCommand(String, OleDbConnection, OleDbTransaction) |
Inicializuje novou instanci třídy OleDbCommand s textem dotazu, OleDbConnectiona Transaction. |
Vlastnosti
CanRaiseEvents |
Získá hodnotu určující, zda komponenta může vyvolat událost. (Zděděno od Component) |
CommandText |
Získá nebo nastaví příkaz SQL nebo uloženou proceduru ke spuštění ve zdroji dat. |
CommandTimeout |
Získá nebo nastaví dobu čekání (v sekundách) před ukončením pokusu o spuštění příkazu a generování chyby. |
CommandType |
Získá nebo nastaví hodnotu, která určuje, jak CommandText vlastnost je interpretována. |
Connection |
Získá nebo nastaví OleDbConnection používané touto instancí OleDbCommand. |
Container |
Získá IContainer, který obsahuje Component. (Zděděno od Component) |
DbConnection |
Získá nebo nastaví DbConnection používané tímto DbCommand. (Zděděno od DbCommand) |
DbParameterCollection |
Získá kolekci DbParameter objektů. (Zděděno od DbCommand) |
DbTransaction |
Získá nebo nastaví DbTransaction, ve kterém se tento DbCommand objekt spustí. (Zděděno od DbCommand) |
DesignMode |
Získá hodnotu, která označuje, zda Component je aktuálně v režimu návrhu. (Zděděno od Component) |
DesignTimeVisible |
Získá nebo nastaví hodnotu, která určuje, zda objekt příkazu by měl být viditelný v přizpůsobeném ovládacím prvku Windows Forms Designer. |
Events |
Získá seznam obslužných rutin událostí, které jsou připojeny k tomuto Component. (Zděděno od Component) |
Parameters |
Získá OleDbParameterCollection. |
Site |
Získá nebo nastaví ISiteComponent. (Zděděno od Component) |
Transaction |
Získá nebo nastaví OleDbTransaction, ve kterém se OleDbCommand spustí. |
UpdatedRowSource |
Získá nebo nastaví způsob použití výsledků příkazu na DataRow při použití |
Metody
Cancel() |
Pokusí se zrušit provádění OleDbCommand. |
Clone() |
Vytvoří nový OleDbCommand objekt, který je kopií aktuální instance. |
CreateDbParameter() |
Vytvoří novou instanci objektu DbParameter. (Zděděno od DbCommand) |
CreateObjRef(Type) |
Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy serveru sloužícího ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject) |
CreateParameter() |
Vytvoří novou instanci objektu OleDbParameter. |
Dispose() |
Provádí úlohy definované aplikací související s uvolněním, uvolněním nebo resetováním nespravovaných prostředků. (Zděděno od DbCommand) |
Dispose() |
Uvolní všechny prostředky používané Component. (Zděděno od Component) |
Dispose(Boolean) |
Uvolní nespravované prostředky používané DbCommand a volitelně uvolní spravované prostředky. (Zděděno od DbCommand) |
Dispose(Boolean) |
Uvolní nespravované prostředky používané Component a volitelně uvolní spravované prostředky. (Zděděno od Component) |
DisposeAsync() |
Asynchronně disponuje objekt příkazu. (Zděděno od DbCommand) |
Equals(Object) |
Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object) |
ExecuteDbDataReader(CommandBehavior) |
Spustí příkaz proti jeho připojení a vrátí DbDataReader, který lze použít pro přístup k výsledkům. (Zděděno od DbCommand) |
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) |
Zprostředkovatelé by měli tuto metodu implementovat, aby poskytovali ne výchozí implementaci pro ExecuteReader přetížení. Výchozí implementace vyvolá synchronní ExecuteReader() metodu a vrátí dokončenou úlohu, která blokuje volající vlákno. Výchozí implementace vrátí zrušený úkol, pokud už byl zrušený token zrušení. Výjimky vyvolané ExecuteReader budou oznámeny prostřednictvím vrácené Task Exception vlastnost. Tato metoda přijímá token zrušení, který lze použít k vyžádání operace, aby byla zrušena dříve. Implementace můžou tento požadavek ignorovat. (Zděděno od DbCommand) |
ExecuteNonQuery() |
Provede příkaz SQL na Connection a vrátí počet ovlivněných řádků. |
ExecuteNonQueryAsync() |
Asynchronní verze ExecuteNonQuery(), která spustí příkaz proti jeho objektu připojení, vrací počet ovlivněných řádků. Vyvolá ExecuteNonQueryAsync(CancellationToken) pomocí CancellationToken.None. (Zděděno od DbCommand) |
ExecuteNonQueryAsync(CancellationToken) |
Toto je asynchronní verze ExecuteNonQuery(). Poskytovatelé by měli přepsat příslušnou implementací. Token zrušení může být volitelně ignorován. Výchozí implementace vyvolá synchronní ExecuteNonQuery() metodu a vrátí dokončenou úlohu, která blokuje volající vlákno. Výchozí implementace vrátí zrušený úkol, pokud už byl zrušený token zrušení. Výjimky vyvolané ExecuteNonQuery() budou předány prostřednictvím vrácené vlastnosti Exception úlohy. Nevyvolejte jiné metody a vlastnosti |
ExecuteReader() |
Odešle CommandText do Connection a vytvoří OleDbDataReader. |
ExecuteReader(CommandBehavior) |
Odešle CommandText do Connectiona vytvoří OleDbDataReader pomocí jedné z hodnot CommandBehavior. |
ExecuteReaderAsync() |
Asynchronní verze ExecuteReader, která spustí příkaz proti jeho připojení, vrací DbDataReader, které lze použít pro přístup k výsledkům. Vyvolá ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) pomocí CancellationToken.None. (Zděděno od DbCommand) |
ExecuteReaderAsync(CancellationToken) |
Asynchronní verze ExecuteReader, která spustí příkaz proti jeho připojení, vrací DbDataReader, které lze použít pro přístup k výsledkům. Vyvolá ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Zděděno od DbCommand) |
ExecuteReaderAsync(CommandBehavior) |
Asynchronní verze ExecuteReader, která spustí příkaz proti jeho připojení, vrací DbDataReader, které lze použít pro přístup k výsledkům. Vyvolá ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Zděděno od DbCommand) |
ExecuteReaderAsync(CommandBehavior, CancellationToken) |
Vyvolá ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Zděděno od DbCommand) |
ExecuteScalar() |
Spustí dotaz a vrátí první sloupec prvního řádku v sadě výsledků vrácených dotazem. Další sloupce nebo řádky se ignorují. |
ExecuteScalarAsync() |
Asynchronní verze ExecuteScalar(), která spustí příkaz a vrátí první sloupec prvního řádku v první vrácené sadě výsledků. Všechny ostatní sloupce, řádky a sady výsledků se ignorují. Vyvolá ExecuteScalarAsync(CancellationToken) pomocí CancellationToken.None. (Zděděno od DbCommand) |
ExecuteScalarAsync(CancellationToken) |
Toto je asynchronní verze ExecuteScalar(). Poskytovatelé by měli přepsat příslušnou implementací. Token zrušení může být volitelně ignorován. Výchozí implementace vyvolá synchronní ExecuteScalar() metodu a vrátí dokončenou úlohu, která blokuje volající vlákno. Výchozí implementace vrátí zrušený úkol, pokud už byl zrušený token zrušení. Výjimky vyvolané ExecuteScalar budou oznámeny prostřednictvím vrácené task Exception vlastnost. Nevyvolejte jiné metody a vlastnosti |
GetHashCode() |
Slouží jako výchozí funkce hash. (Zděděno od Object) |
GetLifetimeService() |
Zastaralé.
Načte objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject) |
GetService(Type) |
Vrátí objekt, který představuje službu poskytovanou Component nebo jeho Container. (Zděděno od Component) |
GetType() |
Získá Type aktuální instance. (Zděděno od Object) |
InitializeLifetimeService() |
Zastaralé.
Získá objekt služby životnosti pro řízení zásad životnosti pro tuto instanci. (Zděděno od MarshalByRefObject) |
MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object) |
MemberwiseClone(Boolean) |
Vytvoří mělkou kopii aktuálního objektu MarshalByRefObject. (Zděděno od MarshalByRefObject) |
Prepare() |
Vytvoří připravenou (nebo zkompilovanou) verzi příkazu ve zdroji dat. |
PrepareAsync(CancellationToken) |
Asynchronně vytvoří připravenou (nebo zkompilovanou) verzi příkazu ve zdroji dat. (Zděděno od DbCommand) |
ResetCommandTimeout() |
Obnoví vlastnost CommandTimeout na výchozí hodnotu. |
ToString() |
Vrátí String obsahující název Component, pokud existuje. Tato metoda by neměla být přepsána. (Zděděno od Component) |
Událost
Disposed |
Nastane, když komponenta je uvolněna voláním Dispose() metody. (Zděděno od Component) |
Explicitní implementace rozhraní
ICloneable.Clone() |
Popis tohoto člena najdete v tématu Clone(). |
IDbCommand.Connection |
Získá nebo nastaví IDbConnection používané touto instancí IDbCommand. (Zděděno od DbCommand) |
IDbCommand.CreateParameter() |
Toto rozhraní API podporuje produktovou infrastrukturu a není určené k použití přímo z uživatelského kódu. Vytvoří novou instanci objektu IDbDataParameter. |
IDbCommand.CreateParameter() |
Vytvoří novou instanci objektu IDbDataParameter. (Zděděno od DbCommand) |
IDbCommand.ExecuteReader() |
Popis tohoto člena najdete v tématu ExecuteReader(). |
IDbCommand.ExecuteReader(CommandBehavior) |
Spustí CommandText proti Connectiona vytvoří IDataReader pomocí jedné z hodnot CommandBehavior. |
IDbCommand.Parameters |
Získá IDataParameterCollection. (Zděděno od DbCommand) |
IDbCommand.Transaction |
Získá nebo nastaví DbTransaction, ve kterém se tento DbCommand objekt spustí. (Zděděno od DbCommand) |
Metody rozšíření
ConfigureAwait(IAsyncDisposable, Boolean) |
Konfiguruje, jak čekají na úlohy vrácené z asynchronního jednorázového použití. |
Platí pro
Viz také
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro