OleDbCommand Třída

Definice

Obor názvů:

System.Data.OleDb

Sestavení:

System.Data.OleDb.dll

Balíček:

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

Zdroj:

OleDbCommand.cs

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

[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

Dědičnost

Object

DbCommand

OleDbCommand

Atributy

RequiresDynamicCodeAttribute

Implementuje

IDbCommand ICloneable IDisposable

Příklady

V následujícím příkladu OleDbCommandOleDbDataAdapter se k výběru řádků z accessové databáze používá spolu a OleDbConnectiondalší řádky. Vyplněný DataSet se pak vrátí. Příklad se předá inicializovanému DataSetpřipojovacímu řetězci, řetězci dotazu, který je příkazem SQL SELECT, a řetězcem, 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 počáteční hodnoty. Seznam těchto hodnot naleznete v konstruktoru OleDbCommand .

OleDbCommand funkce následujících metod, 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 můžete resetovat CommandText a znovu použít OleDbCommand objekt. Před spuštěním nového nebo předchozího příkazu však musíte zavřít OleDbDataReader příkaz.

Pokud je závažná OleDbException (například úroveň závažnosti SQL Serveru 20 nebo vyšší) vygenerována metodou spuštění OleDbCommand, OleDbConnectionmůže být připojení uzavřeno. Uživatel ale může znovu otevřít připojení a pokračovat.

Konstruktory

Name	Description
OleDbCommand()	Inicializuje novou instanci OleDbCommand třídy.
OleDbCommand(String, OleDbConnection, OleDbTransaction)	Inicializuje novou instanci OleDbCommand třídy s textem dotazu, an OleDbConnectiona Transaction.
OleDbCommand(String, OleDbConnection)	Inicializuje novou instanci OleDbCommand třídy s textem dotazu a .OleDbConnection
OleDbCommand(String)	Inicializuje novou instanci OleDbCommand třídy s textem dotazu.

Vlastnosti

Name	Description
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 je vlastnost interpretována.
Connection	Získá nebo nastaví OleDbConnection používané touto instancí OleDbCommand.
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.
Parameters	OleDbParameterCollectionZíská .
Transaction	Získá nebo nastaví, OleDbTransaction ve kterém se OleDbCommand provede.
UpdatedRowSource	Získá nebo nastaví, jak se výsledky příkazu použijí na DataRow při použití Update metodou OleDbDataAdapter.

Metody

Name	Description
Cancel()	Pokusí se zrušit spuštění .OleDbCommand
Clone()	Vytvoří nový OleDbCommand objekt, který je kopií aktuální instance.
CreateParameter()	Vytvoří novou instanci objektu OleDbParameter .
ExecuteNonQuery()	Provede příkaz SQL na Connection základě a vrátí počet ovlivněnýchřádkůch
ExecuteReader()	CommandText Odešle na Connection a vytvoří .OleDbDataReader
ExecuteReader(CommandBehavior)	CommandText Odešle hodnotu do objektu Connectiona vytvoří některou OleDbDataReader z CommandBehavior hodnot.
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í.
Prepare()	Vytvoří připravenou (nebo zkompilovanou) verzi příkazu ve zdroji dat.
ResetCommandTimeout()	CommandTimeout Obnoví vlastnost na výchozí hodnotu.

Explicitní implementace rozhraní

Name	Description
ICloneable.Clone()	Popis tohoto člena naleznete v tématu Clone().
IDbCommand.ExecuteReader()	Popis tohoto člena naleznete v tématu ExecuteReader().
IDbCommand.ExecuteReader(CommandBehavior)	Provede proti objektu CommandTextConnectiona vytvoří IDataReader pomocí jedné z CommandBehavior hodnot.

Viz také

• OleDbDataAdapter
• OleDbConnection
• Práce s příkazy