OleDbCommand.ExecuteScalar メソッド
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
クエリを実行し、クエリによって返される結果セットの先頭行の最初の列を返します。 その他の列または行は無視されます。
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();
製品 | バージョン |
---|---|
.NET | 8 (package-provided), 9 (package-provided) |
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7 (package-provided), 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1 |
.NET Standard | 2.0 (package-provided) |
.NET に関するフィードバック
.NET はオープンソース プロジェクトです。 フィードバックを提供するにはリンクを選択します。