RecordContainerRetentionMode プロパティ

アクティブ化解除されたレコード コンテナーが、ビジュアル ツリーに次回使用するために保持されるかどうかを取得または設定します。

シンタックス

Visual Basic

'宣言
 
Public Property RecordContainerRetentionMode As RecordContainerRetentionMode

C#

public RecordContainerRetentionMode RecordContainerRetentionMode {get; set;}

プロパティ値

'RetainDeactivatedContainersPermanently' に設定すると、使用されていないレコード コンテナーを DataSource が変更されたか、クリアされた後に保持します。'RetainDeactivatedContainers' に設定すると、DataSource が変更されたか、クリアされたまでにレコード コンテナーを保持します。'RetainDeactivatedContainersUntilResize' に設定すると、コントロールがより小さくサイズ変更されたまでにコンテナーを保持します。それ以外の場合、'DiscardDeactivatedContainers' に設定します。デフォルトは 'RetainDeactivatedContainersUntilResize' です。

解説

このプロパティが 'RetainDeactivatedContainersPermanently'、'RetainDeactivatedContainers'、または 'RetainDeactivatedContainersUntilResize' に設定されると、ハイドレートされているのに現在の表示で使用されていないレコード コンテナーがビジュアル ツリー (縮小化) に保持され、再利用できます。表示変更の DataRecords、GroupByRecords、および SummaryRecords の複合などのシナリオに基づいて、スクロールのパフォーマンスを向上できます。RecordContainerGenerationMode が 'Recycle' 以外の値に設定されるか、GridView を使用していないか、GridViewSettings.UseNestedPanels が true の場合、このプロパティは無視されます。

注:このプロパティが 'RetainDeactivatedContainersPermanently' に設定され、その他の値に設定された場合、すべての保持されたコンテナーは破棄されます。