ReCalc(Int64) メソッド

計算ネットワークのダーティな項目すべてを強制的に再計算します。

シンタックス

Visual Basic

'宣言
 
Public Overloads Function ReCalc( _
   ByVal millis As Long _
) As Boolean

C#

public bool ReCalc( 
   long millis
)

パラメータ

millis

計算が始まってから制御が呼び出し元に戻るまでの最大許容時間 (ミリ秒)。無期限に待機する場合は-１を指定します。

戻り値の型

計算ネットワーク内にダーティな項目が残っているかどうかを示すブール値を返します。

例外

例外	解説
System.ArgumentOutOfRangeException	millisに指定された値が -１ より小さい場合、またはクロック刻み数に変換できないほど大きい場合にスローされます。 millis の正確な上限はマシンのハードウェアクロックの精度によって異なりますが、妥当な長さより大きいことは確実です。無期限に待機する場合は、代わりに -１を使用してください。

解説

このメソッドを使用すると、_CALCMANAGER_ が計算の実行に費やすタイムスライスの長さを制限できます。指定した時間が経過する前にすべての計算が完了した場合は、ただちに呼び出し元に制御が戻ります。この時間間隔が短すぎると、過度のタスク切り替えが発生し、計算にかかる時間が通常より遅くなります。したがって、アプリケーションのユーザー応答性が許す限り長い時間に設定することをお勧めします。

使用例

Visual Basic

Imports Infragistics.Shared
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinGrid
Imports Infragistics.Win.CalcEngine
Imports Infragistics.Win.UltraWinCalcManager


    Private Sub Button1_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button1.Click
        Me.UltraCalcManager1.NamedReferences.Clear()

        Me.UltraCalcManager1.NamedReferences.Add("N1", "5")
        Me.ultraCalcManager1.NamedReferences.Add("N2", "2 * [N1]")

        Dim result As UltraCalcValue
        result = Me.UltraCalcManager1.NamedReferences("N2").FormulaResult
        System.Diagnostics.Debug.WriteLine("Result before calling Recalc: " & result.ToString())

        Me.UltraCalcManager1.ReCalc(-1)

        result = Me.UltraCalcManager1.NamedReferences("N2").FormulaResult
        System.Diagnostics.Debug.WriteLine("Result after calling Recalc: " & result.ToString())
    End Sub

C#

using Infragistics.Shared;
using Infragistics.Win;
using Infragistics.Win.UltraWinGrid;
using System.Diagnostics;
using Infragistics.Win.CalcEngine;
using Infragistics.Win.UltraWinCalcManager;


		private void button1_Click(object sender, System.EventArgs e)
		{
			this.ultraCalcManager1.NamedReferences.Clear( );

			this.ultraCalcManager1.NamedReferences.Add( "N1", "5" );
			this.ultraCalcManager1.NamedReferences.Add( "N2", "2 * [N1]" );

			UltraCalcValue result;			
			result = this.ultraCalcManager1.NamedReferences["N2"].FormulaResult;
			System.Diagnostics.Debug.WriteLine( "Result before calling Recalc: " + result.ToString( ) );

			this.ultraCalcManager1.ReCalc( -1 );

			result = this.ultraCalcManager1.NamedReferences["N2"].FormulaResult;
			System.Diagnostics.Debug.WriteLine( "Result after calling Recalc: " + result.ToString( ) );
		}