DataTable.Compute メソッド

.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)

C#

public Object Compute (
    string expression,
    string filter
)

C++

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

J#

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

C#

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");
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
DataTable クラス
DataTable メンバ
System.Data 名前空間
その他の技術情報
DataTable の作成と使用