AddFilterAsync(String,Boolean,Control) メソッド

OLAP サーバーへ非同期要求を送信し、指定した階層を指定したフィルター軸に追加します。

シンタックス

Visual Basic

'宣言
 
Public Overloads Function AddFilterAsync( _
   ByVal hierarchyUniqueName As String, _
   Optional ByVal update As Boolean, _
   Optional ByVal control As Control _
) As Boolean

C#

public bool AddFilterAsync( 
   string hierarchyUniqueName,
   bool update,
   Control control
)

パラメータ

hierarchyUniqueName

追加される階層の一意の名前。指定した一意の名前が解決できない場合、HierarchyNotFoundException 例外がスローされます。

update

データソースを直ちに更新するかどうかを示すオプションのブール値。

デフォルト値が true の場合、OLAP サーバーへ直ちに要求を送信し、サーバーの応答を受け取った際に AddFilterAsyncCompleted イベントを発生します。

False を指定すると、 UpdateAsync メソッドを呼び出すまで、要求はサーバーに送信されません。

control

コントロールへのオプションの参照。指定した場合、このコントロールの処理が作成されたスレッドで AddFilterAsyncCompleted イベントが発生されます。このアプローチにより、イベント ハンドーラからコントロール　メンバーに直接アクセスできます。

解説

このメソッドは、呼び出しスレッドをブロックしないように、OLAP サーバーに要求を送信した直後に返します。ただし、実際の操作は、サーバーがこの要求を返すまで発生しません。この要求は不定期に発生します。