IDbCommand.ExecuteScalar メソッド

定義

名前空間:
System.Data
アセンブリ:
System.Data.dll
アセンブリ:
netstandard.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 参照 (Visual Basicの Nothing) が返されます。 データベース内の値が null場合、クエリは DBNull.Valueを返します。

適用対象