共用方式為


IDbCommand.ExecuteScalar 方法

定義

執行查詢,並傳回查詢所傳回的結果集中第一個資料列的第一個資料行。 額外的資料行或資料列都會遭到忽略。

public:
 System::Object ^ ExecuteScalar();
public object? ExecuteScalar ();
public object ExecuteScalar ();
abstract member ExecuteScalar : unit -> obj
Public Function ExecuteScalar () As 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回 。

適用於