IDbCommand.ExecuteScalar メソッド

定義

クエリを実行し、そのクエリが返す結果セットの最初の行にある最初の列を返します。 追加の列または行は無視されます。

public:
 System::Object ^ ExecuteScalar();
public object? ExecuteScalar ();
public object ExecuteScalar ();
abstract member ExecuteScalar : unit -> obj
Public Function ExecuteScalar () As Object

戻り値

Object

結果セットの最初の行の最初の列。

次の例では、派生クラスのインスタンスを作成し、 SqlCommandそれを使用して ExecuteScalar実行します。 この例では、集計結果を返す Transact-SQL ステートメントである文字列と、データ ソースへの接続に使用する文字列が渡されます。

public void CreateSqlCommand(
    string queryString, SqlConnection connection)
{
    SqlCommand command = new
        SqlCommand(queryString, connection);
    command.Connection.Open();
    command.ExecuteScalar();
    connection.Close();
}
Public Sub CreateSqlCommand( _
    queryString As String, connection As SqlConnection)

    Dim command As New SqlCommand(queryString, connection)
    command.Connection.Open()
    command.ExecuteScalar()
    connection.Close()
End Sub

注釈

このメソッドを ExecuteScalar 使用して、データベースから単一の値 (集計値など) を取得します。 これは、メソッドを使用するよりも少ないコードを ExecuteReader 必要とし、その後、によって返されるデータを使用して単一の値を生成するために必要な操作を IDataReader実行します。

一般的な ExecuteScalar クエリは、次の C# の例のように書式設定できます。

CommandText = "select count(*) as NumberOfRegions from region";  
Int32 count = (int) ExecuteScalar();  

結果セットの最初の行の最初の列が見つからない場合は、null 参照 (NothingVisual Basic) が返されます。 データベース内の値が指定されている場合、クエリDBNull.Valuenull.

適用対象