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();  

如果找不到結果集中第一個數據列的第一個數據行，則會傳回 Visual Basic) 中的 null 參考 Nothing (。 如果資料庫中的值是 null，查詢會傳 DBNull.Value回 。