ExecuteScalar メソッド

SQL SELECT 文を実行し、単一の値を返します。

Visual Basic
Public Overrides Function ExecuteScalar() As Object

C#
public override object ExecuteScalar();

結果セットの最初のローの最初のカラム。結果セットが空の場合は NULL 参照 (Visual Basic の Nothing)。

この文は、必要に応じて ULCommand.CommandText と ULCommand.Parameters が指定された、現在の ULCommand オブジェクトです。

複数のローとカラムを返すクエリでこのメソッドが呼び出されると、最初のローの最初のカラムのみが返されます。

ULCommand.CommandType が System.Data.CommandType.TableDirect である場合、ExecuteScalar は ULCommand.ExecuteTable() を実行し、最初のローの最初のカラムを返します。

SELECT 文は、パフォーマンス上の理由により、デフォルトで読み込み専用とマーク付けされます。クエリを使用して更新を行う場合、SELECT 文は "FOR UPDATE" で終わる必要があります。