コントロールテンプレートの作成後ページ型コンポーネント内の一つまたは複数のロケーションで使用することができます: (I) トップページ (ii) サブページ (iii) コントロールテンプレート。
ページコントロールまたはコントロールテンプレート内でコントロールテンプレートを使用するには以下を行います：
1.デザイン内の プレースホルダコントロール を直接ページまたは テーブルコントロールなどの適切なコントロール内にドロップします。
2.プレースホルダの コントロールテンプレート プロパティを設定してこのロケーションインスタンス化するコントロールテンプレートを選択します。
3.「スタイル & プロパティ」ペイン内で必要とされる通りにプレースホルダコントロールの他の設定を構成します。
繰り返し要素を持つテーブル内でコントロールテンプレートを呼び出す プレースホルダコントロール の挿入はテンプレートをテーブルの各繰り返し要素に適用できるためとても役に立ちます。下のスクリーンショットでは、例えば、複数の兄弟 Country 要素を含む XML データセット内の国に対応する各繰り返し行が存在するテーブルが作成されています。プレースホルダコントロール をテーブルの繰り返し行にドロップし、その コントロールテンプレート プロパティが DataWithParams テンプレートを選択するように設定します。
スクリーンショット内で表示されている通り、コントロールテンプレートには7つの異なる国プロパティのために7個のセルが存在します。現在のプレースホルダでは、3つのプロパティがインスタント化されています。他のプレースホルダ内ではデータん異なる組み合わせを生成するために、異なる個所で同じテンプレートコントロールの呼び出しを可能にし異なる組み合わせのプロパティがインスタント化されます。
他の使用方法のサンプルに関しては サンプルプロジェクト セクションも参照してください。
プレースホルダコントロールの構成方法
プレースホルダコントロールの構成方法は以下の通りです:
1.デザイン内で プレースホルダコントロール をドロップした後、デザインを選択します。
2.「スタイル & プロパティ」ペイン に移動し、プレースホルダコントロールの コントロールテンプレート プロパティが入力するコントロールテンプレート名に正確に設定されていることを確認してください。(下のスクリーンショットでは選択されたコントロールテンプレートは DataWithParams です。デザイン内のすべてのコントロールテンプレートをリストするドロップダウンメニューから選択することができます。)または、 XPath 式を使用してコントロールテンプレートを使用することができます。このような Xpath 式はデザイン内のコントロールテンプレートの名前を評価する必要があります。Xpath 式を使用することによりテンプレートを条件付きで選択できるようになります。 これを行う方法に関してはサンプルプロジェクトを参照してください
3.コントロールテンプレートの選択後、そのパラメーターはテンプレートのサブプロパティとして表示されます(下のスクリーンショットを参照)。Xpath 式としてこれらのパラメーターのために値を入力します。(任意と定義されていないパラメータ)全ての必須のパラメーターのために値を定義する必要があります。パラメーター値の Xpath 式の評価のためのコンテキストノードはプレースホルダコントロールのコンテキストノードです。コントロール Xpath コンテキストプロパティによりパラメーターのためのコンテキストは変更されません (下を参照)。
(プロパティのコンボボックス内の名前を選択する代わりに) Xpath 式を介してコントロールテンプレートを選択すると、 コントロールテンプレートは式が評価されるランタイムまで選択されません。デザイン時にコントロールテンプレートは既知ではないため、ペイン内にパラメーターは表示されません。パラメーターのリストの代わりに テンプレートパラメーター という名前を持つプロパティを使用することができます (下のスクリーンショットを参照).期待されるパラメーターの値を生成する Xpath 式を入力することができます。式は配列式またはマップ式として入力される必要があります。配列式を使用する場合、パラメーターの値はコントロールテンプレート内のパラメーター定義順序と同じシーケンス内で提供される必要があります。更に任意のパラメーターを省略することはできません。(マップの場合、キーは値が正確に割り当てられるようにします。)このような式のサンプルに関しては サンプルプロジェクト を参照してください。
4.コントロールテンプレート内のすべての Xpath 式のコンテキストノードはデフォルトでテンプレートをインスタンス化する (または呼び出す) プレースホルダコントロールのコンテキストノードになります。コントロール Xpath コンテキスト プロパティ の値として新規のノードを入力することによりコントロールテンプレートにパスされるコンテキストノードを変更することができます(上のスクリーンショット参照)。新規のコンテキストノードはテンプレート内のテンプレート変数の値を定義する Xpath 式を評価するために使用されます。
