AxisInsertHierarchyAsync(AxisType,String,Int32,Boolean,Control) メソッド

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

シンタックス

Visual Basic

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

C#

public bool AxisInsertHierarchyAsync( 
   AxisType axisType,
   string hierarchyUniqueName,
   int index,
   bool update,
   Control control
)

パラメータ

axisType

階層を追加する軸。

hierarchyUniqueName

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

index

階層を挿入する順序位置。

update

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

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

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

control

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

戻り値の型

メソッド呼び出しの結果データソースに変更があるかどうかを示すブール値。指定した階層がすでに存在する場合、false が返されて、何も実行されません。

解説

このメソッドは、スレッドの呼び出しをブロックしないように OLAP サーバーへ要求を送信した後すぐに返されます。実際のフィルター処理は、サーバーがこの要求を返す (不定期) まで発生しません。

指定した階層が指定した軸にすでに存在する場合、現在の位置から削除し新しい位置へ挿入します。