InsertFilterAsync(String,Int32,Boolean,Control) メソッド

OLAP サーバーへ非同期要求を送信し、フィルター軸で指定した順序位置に指定した階層を挿入します。

シンタックス

Visual Basic

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

C#

public bool InsertFilterAsync( 
   string hierarchyUniqueName,
   int index,
   bool update,
   Control control
)

パラメータ

hierarchyUniqueName

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

index

階層を挿入するオプションの順序位置。値を指定しない場合、階層は最後のメジャーとしてフィルター軸に追加されます。

update

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

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

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

false に設定した場合、AddFilterAsyncCompleted イベントは発生しないことに注意してください。

control

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

解説

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