バージョン

フィールド カスタマイズのロード

xamDataGrid™ コントロールまたは xamDataPresenter™ コントロールを使用して、エンドユーザーはランタイムにフィールドの移動、並べ替え、およびグループ化ができます。xamDataCarousel™ コントロールは、フィールドヘッダーを表示しないので、エンドユーザーにフィールドのグループ化だけを許可します。エンドユーザーは、アプリケーションの再起動時にフィールドを修正する必要がないように、これらのカスタマイズの保存およびロードを開発者に期待します。DataPresenterBase クラスは、以前に保存したフィールドカスタマイズをロードするために使用できるオーバーロードされた LoadCustomizations メソッドを公開します。FieldLayout オブジェクトの Key プロパティがレイアウトファイルのキー値に一致しない場合、データ プレゼンターはレイアウト ファイルからのカスタマイズを適用しません。

以下のコード例は、フィールド カスタマイズをロードする方法を示します。コード例は xamDataGrid コントロールのインスタンスを使用しますが、xamDataPresenter コントロールまたは xamDataCarousel コントロールを使用できます。

Visual Basic の場合:

Imports System.IO
...
Using fs As New FileStream("xamDataGridLayout1.xml", FileMode.Open, FileAccess.Read)
    Me.xamDataGrid1.LoadCustomizations(fs)
End Using
...

C# の場合:

using System.IO;
...
//ストリームからレイアウトをロードします。
using(FileStream fs = new FileStream("xamDataGridLayout1.xml", FileMode.Open, FileAccess.Read))
{
    this.xamDataGrid1.LoadCustomizations(fs);
}
...