共用方式為


OleDbCommand.ExecuteScalar 方法

定義

執行查詢,並傳回查詢所傳回之結果集中第一個資料列的第一個資料行。 忽略其他資料行或資料列。

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

傳回

結果集中第一個資料列的第一個資料行,如果結果集為空白,則為 null 參考。

實作

例外狀況

如果某項交易內容與原本連接登記的內容不同,便無法在那個交易內容中執行命令。

範例

下列範例會建立 , OleDbCommand 然後使用 執行它 ExecuteScalar。 此範例會傳遞字串,該字串是傳回匯總結果的 SQL 語句,以及用來連接到數據源的字串。

public void CreateMyOleDbCommand(string queryString,
    OleDbConnection connection)
{
    OleDbCommand command = new OleDbCommand(queryString, connection);
    command.Connection.Open();
    command.ExecuteScalar();
    connection.Close();
}
Public Sub CreateMyOleDbCommand(queryString As String, _
    connection As OleDbConnection)
    Dim command As New OleDbCommand(queryString, connection)
    command.Connection.Open()
    command.ExecuteScalar()
    connection.Close()
End Sub

備註

ExecuteScalar使用 方法,從數據源擷取單一值,例如匯總值。 這需要比使用 ExecuteReader 方法少的程式代碼,然後執行使用 傳回的數據產生單一 OleDbDataReader值所需的作業。

一般 ExecuteScalar 查詢的格式可以如下列 C# 範例所示:

CommandText = "SELECT COUNT(*) FROM region";  
Int32 count = (Int32) ExecuteScalar();  

適用於

另請參閱