DataTable.Compute メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

DataTable.Compute メソッド

フィルタ基準を満たしている現在の行で指定した式を計算します。

名前空間: System.Data
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Function Compute ( _
    expression As String, _
    filter As String _
) As Object

Visual Basic (使用法)

Dim instance As DataTable
Dim expression As String
Dim filter As String
Dim returnValue As Object

returnValue = instance.Compute(expression, filter)

public Object Compute (
    string expression,
    string filter
)

C++

public:
Object^ Compute (
    String^ expression, 
    String^ filter
)

public Object Compute (
    String expression, 
    String filter
)

JScript

public function Compute (
    expression : String, 
    filter : String
) : Object

パラメータ

expression: 計算する式。

filter: 式で評価される行を制限するフィルタ。

戻り値
計算の結果に設定された Object。

解説

expression パラメータには集約関数が必要です。たとえば、次の式は有効です。

Count(Quantity)

次の式は無効です。

Sum (Quantity * UnitPrice)

2 つ以上の列で操作を実行する必要がある場合は、DataColumn を作成し、この列の Expression プロパティを適切な式に設定し、結果の列で集約式を使用します。この場合は、DataColumn が "total" という名前で、Expression プロパティが次のように設定されているとします。

"Quantity * UnitPrice"

Compute メソッドの式の引数は次のようになります。

Sum(total)

2 番目のパラメータ filter は、式で使用する行を指定します。たとえば、テーブルに "colDate" という名前の日付列がある場合は、次の式で行を制限できます。

colDate > 1/1/99 AND colDate < 17/1/99

両方のパラメータの式を作成するときの規則については、DataColumn.Expression プロパティのトピックを参照してください。

使用例

識別番号 5 が割り当てられた営業担当者の、"Total" という名前の列の値を合計する例を次に示します。

Visual Basic

Private Sub ComputeBySalesSalesID(ByVal
 dataSet As DataSet)
    ' Presumes a DataTable named "Orders" that has a column
 named "Total."
    Dim table As DataTable
    table = dataSet.Tables("Orders")

    ' Declare an object variable.
    Dim sumObject As Object
    sumObject = table.Compute("Sum(Total)", "EmpID
 = 5")
 End Sub

private void ComputeBySalesSalesID(DataSet
 dataSet)
{
    // Presumes a DataTable named "Orders" that has a column
 named "Total."
    DataTable table;
    table = dataSet.Tables["Orders"];

    // Declare an object variable.
    object sumObject;
    sumObject = table.Compute("Sum(Total)", "EmpID = 5");
}