このプロパティは、グリッドに読み込みするバンドを一定数に制限する場合に使用します。これは、テーブルがそれ自体に関連する再帰的なデータ リレーションを使用する場合に、ドリルダウンするバンド階層を一定のレベルに制限するときに役立ちます。
このプロパティのデフォルト値は 100 で、範囲は 1~100 です(1 と 100 を含みます)。1 より小さい値または 100 より大きい値を設定すると、ArgumentOutOfRange 例外がスローされます。
注: MaxBandDepth プロパティを有効にするためには、UltraGrid をデータソースにバインドする前にこのプロパティを設定する必要があります。
Imports Infragistics.Shared Imports Infragistics.Win Imports Infragistics.Win.UltraWinGrid Private Sub Button20_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button20.Click ' Load only upto two descendant bands. So even if the data source has more than 2 level ' deep hierarchy, the UltraGrid will only make use of first two levels and ignore the ' levels deeper than that. Me.ultraGrid1.DisplayLayout.MaxBandDepth = 2 Me.ultraGrid1.SetDataBinding(Me.ultraGrid1.DataSource, "") End Sub
using Infragistics.Shared; using Infragistics.Win; using Infragistics.Win.UltraWinGrid; using System.Diagnostics; private void button20_Click(object sender, System.EventArgs e) { // Load only upto two descendant bands. So even if the data source has more than 2 level // deep hierarchy, the UltraGrid will only make use of first two levels and ignore the // levels deeper than that. this.ultraGrid1.DisplayLayout.MaxBandDepth = 2; this.ultraGrid1.SetDataBinding( this.ultraGrid1.DataSource, "" ); }