OleDbCommand Klass

Definition

Namnområde:: System.Data.OleDb

Sammansättning:: System.Data.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Representerar en SQL-instruktion eller lagrad procedur som ska köras mot en datakälla.

public ref class OleDbCommand sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbCommand

public ref class OleDbCommand sealed : 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, IDisposable

type OleDbCommand = class
    inherit Component
    interface ICloneable
    interface IDbCommand
    interface IDisposable

type OleDbCommand = class
    inherit DbCommand
    interface ICloneable
    interface IDbCommand
    interface IDisposable

Public NotInheritable Class OleDbCommand
Inherits Component
Implements ICloneable, IDbCommand, IDisposable

Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable, IDisposable

Arv: Object

MarshalByRefObject

Component
OleDbCommand

Arv: Object

MarshalByRefObject

Component

DbCommand
OleDbCommand

Implementeringar: IDbCommand ICloneable IDisposable

Exempel

I följande exempel används OleDbCommand, tillsammans OleDbDataAdapter och OleDbConnection, för att välja rader från en Access-databas. Fyllnad DataSet returneras sedan. Exemplet skickas en initierad DataSet, en reťazec pripojenia, en frågesträng som är en SQL SELECT-instruktion och en sträng som är namnet på källdatabastabellen.

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

Kommentarer

När en instans av OleDbCommand skapas ställs läs-/skrivegenskaperna in på deras initiala värden. En lista över dessa värden finns i OleDbCommand konstruktorn.

OleDbCommand innehåller följande metoder för att köra kommandon på en datakälla:

Objekt	Description
ExecuteReader	Kör kommandon som returnerar rader. ExecuteReader kanske inte har den effekt som du vill ha om det används för att köra kommandon som SQL SET-instruktioner.
ExecuteNonQuery	Kör kommandon som SQL INSERT-, DELETE-, UPDATE- och SET-instruktioner.
ExecuteScalar	Hämtar ett enda värde, till exempel ett aggregerat värde från en databas.

Du kan återställa CommandText egenskapen och återanvända objektet OleDbCommand . Du måste dock stänga OleDbDataReader innan du kan köra ett nytt eller tidigare kommando.

Om en allvarlig OleDbException (till exempel en SQL Server allvarlighetsgrad på 20 eller högre) genereras av metoden som kör en OleDbCommand, OleDbConnection, kan anslutningen stängas. Användaren kan dock öppna anslutningen igen och fortsätta.

Konstruktorer

Name	Description
OleDbCommand()	Initierar en ny instans av OleDbCommand klassen.
OleDbCommand(String, OleDbConnection, OleDbTransaction)	Initierar en ny instans av OleDbCommand klassen med texten i frågan, en OleDbConnection, och Transaction.
OleDbCommand(String, OleDbConnection)	Initierar en ny instans av OleDbCommand klassen med texten i frågan och en OleDbConnection.
OleDbCommand(String)	Initierar en ny instans av OleDbCommand klassen med texten i frågan.

Egenskaper

Name	Description
CanRaiseEvents	Hämtar ett värde som anger om komponenten kan generera en händelse. (Ärvd från Component)
CommandText	Hämtar eller anger SQL-instruktionen eller den lagrade proceduren som ska köras vid datakällan.
CommandTimeout	Hämtar eller anger väntetiden (i sekunder) innan ett försök att köra ett kommando avslutas och ett fel genereras.
CommandType	Hämtar eller anger ett värde som anger hur egenskapen CommandText tolkas.
Connection	Hämtar eller anger den OleDbConnection som används av den här instansen OleDbCommandav .
Container	Hämtar som IContainer innehåller Component. (Ärvd från Component)
DbConnection	Hämtar eller anger den DbConnection som används av den här DbCommand. (Ärvd från DbCommand)
DbParameterCollection	Hämtar samlingen med DbParameter objekt. (Ärvd från DbCommand)
DbTransaction	Hämtar eller anger inom DbTransaction vilken det här DbCommand objektet körs. (Ärvd från DbCommand)
DesignMode	Hämtar ett värde som anger om det Component för närvarande är i designläge. (Ärvd från Component)
DesignTimeVisible	Hämtar eller anger ett värde som anger om kommandoobjektet ska visas i en anpassad Windows Forms Designer-kontroll.
Events	Hämtar listan över händelsehanterare som är kopplade till den här Component. (Ärvd från Component)
Parameters	OleDbParameterCollectionHämtar .
Site	Hämtar eller ställer in ISite i Component. (Ärvd från Component)
Transaction	Hämtar eller anger inom OleDbTransaction vilken OleDbCommand körs.
UpdatedRowSource	Hämtar eller anger hur kommandoresultat tillämpas på DataRow när de `Update` används av metoden för OleDbDataAdapter.

Metoder

Name	Description
Cancel()	Försöker avbryta körningen av en OleDbCommand.
Clone()	Skapar ett nytt OleDbCommand objekt som är en kopia av den aktuella instansen.
CreateDbParameter()	Skapar en ny instans av ett DbParameter objekt. (Ärvd från DbCommand)
CreateObjRef(Type)	Skapar ett objekt som innehåller all relevant information som krävs för att generera en proxy som används för att kommunicera med ett fjärrobjekt. (Ärvd från MarshalByRefObject)
CreateParameter()	Skapar en ny instans av ett OleDbParameter objekt.
Dispose()	Släpper alla resurser som används av Component. (Ärvd från Component)
Dispose(Boolean)	Släpper de ohanterade resurser som används av Component och släpper eventuellt de hanterade resurserna. (Ärvd från Component)
Equals(Object)	Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object)
ExecuteDbDataReader(CommandBehavior)	Kör kommandot mot anslutningen och returnerar en DbDataReader som kan användas för att komma åt resultaten. (Ärvd från DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)	Leverantörer bör implementera den här metoden för att tillhandahålla en icke-standardimplementering för ExecuteReader överlagringar. Standardimplementeringen anropar den synkrona ExecuteReader() metoden och returnerar en slutförd uppgift som blockerar den anropande tråden. Standardimplementeringen returnerar en avbruten aktivitet om den skickas en redan avbruten annulleringstoken. Undantag som genereras av ExecuteReader kommuniceras via den returnerade egenskapen Aktivitetsfel. Den här metoden accepterar en annulleringstoken som kan användas för att begära att åtgärden avbryts tidigt. Implementeringar kan ignorera den här begäran. (Ärvd från DbCommand)
ExecuteNonQuery()	Kör en SQL-instruktion mot Connection och returnerar antalet rader som påverkas.
ExecuteNonQueryAsync()	En asynkron version av ExecuteNonQuery(), som kör kommandot mot dess anslutningsobjekt och returnerar antalet rader som påverkas. Anropar ExecuteNonQueryAsync(CancellationToken) med CancellationToken.None. (Ärvd från DbCommand)
ExecuteNonQueryAsync(CancellationToken)	Det här är den asynkrona versionen av ExecuteNonQuery(). Leverantörer bör åsidosätta med en lämplig implementering. Annulleringstoken kan eventuellt ignoreras. Standardimplementeringen anropar den synkrona ExecuteNonQuery() metoden och returnerar en slutförd uppgift som blockerar den anropande tråden. Standardimplementeringen returnerar en avbruten aktivitet om den skickas en redan avbruten annulleringstoken. Undantag som genereras av ExecuteNonQuery() kommer att kommuniceras via den returnerade egenskapen Aktivitetsfel. Anropa inte andra metoder och egenskaper för `DbCommand` objektet förrän den returnerade aktiviteten har slutförts. (Ärvd från DbCommand)
ExecuteReader()	CommandText Skickar till Connection och skapar en OleDbDataReader.
ExecuteReader(CommandBehavior)	CommandText Skickar till Connectionoch skapar ett OleDbDataReader med ett av CommandBehavior värdena.
ExecuteReaderAsync()	En asynkron version av ExecuteReader, som kör kommandot mot dess anslutning och returnerar en DbDataReader som kan användas för att komma åt resultaten. Anropar ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) med CancellationToken.None. (Ärvd från DbCommand)
ExecuteReaderAsync(CancellationToken)	En asynkron version av ExecuteReader, som kör kommandot mot dess anslutning och returnerar en DbDataReader som kan användas för att komma åt resultaten. Anropar ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Ärvd från DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Anropar ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Ärvd från DbCommand)
ExecuteReaderAsync(CommandBehavior)	En asynkron version av ExecuteReader, som kör kommandot mot dess anslutning och returnerar en DbDataReader som kan användas för att komma åt resultaten. Anropar ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Ärvd från DbCommand)
ExecuteScalar()	Kör frågan och returnerar den första kolumnen i den första raden i resultatuppsättningen som returneras av frågan. Ytterligare kolumner eller rader ignoreras.
ExecuteScalarAsync()	En asynkron version av ExecuteScalar(), som kör kommandot och returnerar den första kolumnen på den första raden i den första returnerade resultatuppsättningen. Alla andra kolumner, rader och resultatuppsättningar ignoreras. Anropar ExecuteScalarAsync(CancellationToken) med CancellationToken.None. (Ärvd från DbCommand)
ExecuteScalarAsync(CancellationToken)	Det här är den asynkrona versionen av ExecuteScalar(). Leverantörer bör åsidosätta med en lämplig implementering. Annulleringstoken kan eventuellt ignoreras. Standardimplementeringen anropar den synkrona ExecuteScalar() metoden och returnerar en slutförd uppgift som blockerar den anropande tråden. Standardimplementeringen returnerar en avbruten aktivitet om den skickas en redan avbruten annulleringstoken. Undantag som genereras av ExecuteScalar kommuniceras via den returnerade egenskapen Aktivitetsfel. Anropa inte andra metoder och egenskaper för `DbCommand` objektet förrän den returnerade aktiviteten har slutförts. (Ärvd från DbCommand)
GetHashCode()	Fungerar som standard-hash-funktion. (Ärvd från Object)
GetLifetimeService()	Hämtar det aktuella livslängdstjänstobjektet som styr livslängdsprincipen för den här instansen. (Ärvd från MarshalByRefObject)
GetService(Type)	Returnerar ett objekt som representerar en tjänst som tillhandahålls av Component eller av dess Container. (Ärvd från Component)
GetType()	Hämtar den aktuella instansen Type . (Ärvd från Object)
InitializeLifetimeService()	Hämtar ett tjänstobjekt för livslängd för att styra livslängdsprincipen för den här instansen. (Ärvd från MarshalByRefObject)
MemberwiseClone()	Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object)
MemberwiseClone(Boolean)	Skapar en ytlig kopia av det aktuella MarshalByRefObject objektet. (Ärvd från MarshalByRefObject)
Prepare()	Skapar en förberedd (eller kompilerad) version av kommandot på datakällan.
ResetCommandTimeout()	Återställer egenskapen CommandTimeout till standardvärdet.
ToString()	Returnerar ett String som innehåller namnet på Component, om det finns. Den här metoden bör inte åsidosättas. (Ärvd från Component)

Händelser

Name	Description
Disposed	Inträffar när komponenten tas bort av ett anrop till Dispose() metoden. (Ärvd från Component)

Explicita gränssnittsimplementeringar

Name	Description
ICloneable.Clone()	En beskrivning av den här medlemmen finns i Clone().
IDbCommand.Connection	Hämtar eller anger den IDbConnection som används av den här instansen IDbCommandav . (Ärvd från DbCommand)
IDbCommand.CreateParameter()	Detta API stöder produktinfrastrukturen och är inte avsett att användas direkt från koden. Skapar en ny instans av ett IDbDataParameter objekt.
IDbCommand.CreateParameter()	Skapar en ny instans av ett IDbDataParameter objekt. (Ärvd från DbCommand)
IDbCommand.ExecuteReader()	En beskrivning av den här medlemmen finns i ExecuteReader().
IDbCommand.ExecuteReader(CommandBehavior)	CommandText Kör mot Connection, och skapar ett IDataReader med något av CommandBehavior värdena.
IDbCommand.Parameters	IDataParameterCollectionHämtar . (Ärvd från DbCommand)
IDbCommand.Transaction	Hämtar eller anger inom DbTransaction vilken det här DbCommand objektet körs. (Ärvd från DbCommand)

Gäller för

Se även

Feedback

Var den här sidan till hjälp?