OleDbCommand.ExecuteScalar 方法

定義

命名空間:
System.Data.OleDb
組件:
System.Data.dll

執行查詢，並回傳查詢回傳結果集第一列的第一欄。 額外的欄位或列則被忽略。

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

傳回

Object

結果集第一列的第一欄，或若結果集為空，則為空參考。

實作

ExecuteScalar()

例外狀況

InvalidOperationException

無法在交易上下文中執行與原始連線關聯不同的指令。

範例

以下範例將建立 ， 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();

適用於

另請參閱