IDbCommand.ExecuteScalar メソッド

定義

名前空間:

System.Data

アセンブリ:

System.Data.Common.dll

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

public:
 System::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 参照 (Nothing Visual Basic の場合) が返されます。 データベースの値が の場合、クエリは nullを返します DBNull.Value。