ULCommand-Klasse

Repräsentiert eine vorkompilierte SQL-Anweisung oder Abfrage mit oder ohne IN-Parameter.

Visual Basic-Syntax

Public NotInheritable Class ULCommand
    Inherits System.Data.Common.DbCommand
    Implements System.ICloneable

C#-Syntax

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

Mitglieder

Alle Mitglieder der Klasse ULCommand, einschließlich aller geerbten Mitglieder.

Name	Beschreibung
ULCommand-Konstruktor	Initialisiert ein ULCommand-Objekt.
BeginExecuteNonQuery-Methode	Startet die asynchrone Ausführung einer SQL-Anweisung, die durch dieses ULCommand-Objekt beschrieben wird.
BeginExecuteReader-Methode	Startet die asynchrone Ausführung einer SQL-Anweisung, die durch dieses ULCommand-Objekt beschrieben wird, und ruft die Ergebnismenge ab.
Cancel-Methode	Diese Methode wird in UltraLite.NET nicht unterstützt.
CreateParameter-Methode	Stellt ein ULParameter-Objekt bereit, um Parameter an ULCommand-Objekte übergeben zu können.
EndExecuteNonQuery-Methode	Beendet die asynchrone Ausführung einer SQL-Anweisung.
EndExecuteReader-Methode	Beendet die asynchrone Ausführung einer SQL-Anweisung und gibt das angeforderte ULDataReader-Objekt zurück.
ExecuteDbDataReader-Methode (geerbt aus System.Data.Common.DbCommand)	Führt den Befehlstext für die Verbindung aus.
ExecuteNonQuery-Methode	Führt eine Anweisung aus, die keine Ergebnismenge zurückgibt, wie etwa eine SQL INSERT-, DELETE- oder UPDATE-Anweisung.
ExecuteReader-Methode	Führt eine SQL SELECT-Anweisung aus und gibt die Ergebnismenge zurück.
ExecuteResultSet-Methode	UL-Erw.: Führt eine SQL SELECT-Anweisung aus und gibt die Ergebnismenge als ULResultSet-Objekt zurück.
ExecuteScalar-Methode	Führt eine SQL SELECT-Anweisung aus und gibt einen einzelnen Wert zurück.
ExecuteTable-Methode	UL-Erw.: Ruft eine Datenbanktabelle in einem ULTable-Objekt zur direkten Bearbeitung ab.
Prepare-Methode	Präkompiliert die SQL-Anweisung dieses Befehls und speichert sie.
CommandText-Eigenschaft	Gibt den Text der SQL-Anweisung oder den Namen der Tabelle an, wenn die ULCommand.CommandType-Eigenschaft den Wert System.Data.CommandType.TableDirect hat.
CommandTimeout-Eigenschaft	Diese Funktion wird von UltraLite.NET nicht unterstützt.
CommandType-Eigenschaft	Gibt den Typ des auszuführenden Befehls an.
Connection-Eigenschaft	Das Verbindungsobjekt, auf dem das ULCommand-Objekt ausgeführt werden soll.
DesignTimeVisible-Eigenschaft	Gibt an, ob das ULCommand-Objekt in einem benutzerdefinierten Steuerelement des Windows Form-Designers sichtbar sein soll.
IndexName-Eigenschaft	UL-Erw.: Gibt den Namen des Indexes an, mit dem die Tabelle geöffnet (sortiert) werden soll, wenn die ULCommand.CommandType-Eigenschaft den Wert System.Data.CommandType.TableDirect hat.
Parameters-Eigenschaft	Legt die Parameter für die aktuelle Anweisung fest.
Plan-Eigenschaft	UL-Erw.: Gibt den Zugriffsplan zurück, den UltraLite.NET zum Ausführen einer Abfrage verwendet.
Transaction-Eigenschaft	Gibt das ULTransaction-Objekt an, in dem das ULCommand-Objekt ausgeführt wird
UpdatedRowSource-Eigenschaft	Legt fest, wie Ergebnisse von Befehlen auf das DataRow-Objekt angewendet werden, wenn es von der ULDataAdapterUpdate-Methode verwendet wird.

Bemerkungen

Dieses Objekt kann dann dazu verwendet werden, eine Anweisung oder Abfrage auf effiziente Weise wiederholt auszuführen.

ULCommand-Objekte können direkt oder mit der ULConnection.CreateCommand-Methode erstellt werden. Diese Methode stellt sicher, dass der Befehl die richtige Transaktion zur Ausführung von Anweisungen über die betreffende Verbindung enthält.

Die ULCommand.Transaction-Methode muss zurückgesetzt werden, nachdem die aktuelle Transaktion festgeschrieben oder zurückgesetzt wurde.

Die ULCommand-Klasse verfügt über die folgenden Methoden zum Ausführen von Befehlen in einer UltraLite.NET-Datenbank:

Methode	Beschreibung
ULCommand.ExecuteNonQuery	Führt eine Anweisung aus, die keine Ergebnismenge zurückgibt, wie etwa eine SQL INSERT-, DELETE- oder UPDATE-Anweisung.
ULCommand.ExecuteReader()	Führt eine SQL SELECT-Anweisung aus und gibt die Ergebnismenge in einem ULDataReader-Objekt zurück. Verwenden Sie diese Methode zum Erstellen schreibgeschützter Ergebnismengen.
ULCommand.ExecuteResultSet()	UL-Erw.: Führt eine SQL SELECT-Anweisung aus und gibt die Ergebnismenge in einem ULResultSet-Objekt zurück. Verwenden Sie diese Methode zum Erstellen veränderlicher Ergebnismengen.
ULCommand.ExecuteScalar	Führt eine SQL SELECT-Anweisung aus und gibt einen einzelnen Wert zurück.
ULCommand.ExecuteTable()	UL-Erw.: Ruft eine Datenbanktabelle in einem ULTable-Objekt zur direkten Bearbeitung ab. Die ULCommand.CommandText-Eigenschaft wird als Name der Tabelle interpretiert und die ULCommand.IndexName-Eigenschaft kann verwendet werden, um eine Sortierreihenfolge für die Tabelle festzulegen. Die ULCommand.CommandType-Eigenschaft muss den Wert System.Data.CommandType.TableDirect haben.

Sie können die meisten Eigenschaften, einschließlich der ULCommand.CommandText-Eigenschaft, zurücksetzen und das ULCommand-Objekt erneut verwenden.

Aus Gründen der Ressourcenverwaltung wird empfohlen, Anweisungen explizit zu schließen, wenn sie abgeschlossen wurden. In C# können Sie die System.ComponentModel.Component.Dispose-Methode mit einer using-Anweisung automatisch aufrufen oder die System.ComponentModel.Component.Dispose-Methode explizit aufrufen. In Visual Basic müssen Sie die System.ComponentModel.Component.Dispose-Methode explizit aufrufen.

Siehe auch

ULCommand-Konstruktor
BeginExecuteNonQuery-Methode
BeginExecuteReader-Methode
Cancel-Methode
CreateParameter-Methode
EndExecuteNonQuery-Methode
EndExecuteReader-Methode
ExecuteNonQuery-Methode
ExecuteReader-Methode
ExecuteResultSet-Methode
ExecuteScalar-Methode
ExecuteTable-Methode
Prepare-Methode
CommandText-Eigenschaft
CommandTimeout-Eigenschaft
CommandType-Eigenschaft
Connection-Eigenschaft
DesignTimeVisible-Eigenschaft
IndexName-Eigenschaft
Parameters-Eigenschaft
Plan-Eigenschaft
Transaction-Eigenschaft
UpdatedRowSource-Eigenschaft

Kommentieren Sie diese Seite in DocCommentXchange.