ExecuteScalar-Methode

Führt eine SQL SELECT-Anweisung aus und gibt einen einzelnen Wert zurück.

Visual Basic-Syntax

Public Overrides Function ExecuteScalar() As Object

C#-Syntax

public override object ExecuteScalar()

Ausnahmen

ULException-Klasse Es ist ein SQL-Fehler aufgetreten.
InvalidOperationException Der Befehl hat einen ungültigen Status. Entweder fehlt der ULCommand.Connection-Wert oder die Verbindung ist geschlossen, der ULCommand.Transaction-Wert stimmt nicht mit dem aktuellen Transaktionsstatus der Verbindung überein oder der ULCommand.CommandText-Wert ist ungültig.

Bemerkungen

Die Anweisung ist das aktuelle ULCommand-Objekt, mit dem ULCommand.CommandText-Wert und den erforderlichen ULCommand.Parameters-Werten.

Wenn diese Methode in einer Abfrage aufgerufen wird, die mehrere Zeilen und Spalten zurückgibt, wird nur die erste Spalte der ersten Zeile zurückgegeben.

Wenn ULCommand.CommandType den Wert System.Data.CommandType.TableDirect hat, führt die ExecuteScalar-Methode einen ULCommand.ExecuteTable-Aufruf aus und gibt die erste Spalte der ersten Zeile zurück.

SELECT-Anweisungen werden aus Performancegründen standardmäßig als schreibgeschützt gekennzeichnet. Falls die Abfrage für Aktualisierungen verwendet werden soll, muss die Anweisung mit " FOR UPDATE" enden.

Siehe auch

Kommentieren Sie diese Seite in DocCommentXchange.