DataTemplate.GetElement(ElementFactoryGetArgs) メソッド

定義

DataTemplate で宣言された UIElement オブジェクトの既存のインスタンスを作成または取得します。

UIElement GetElement(ElementFactoryGetArgs const& args);
public UIElement GetElement(ElementFactoryGetArgs args);
function getElement(args)
Public Function GetElement (args As ElementFactoryGetArgs) As UIElement

パラメーター

args
ElementFactoryGetArgs

ElementFactoryGetArgs のインスタンス。

戻り値

DataTemplate で宣言されたルート UIElement のインスタンス。 DataTemplate のルートが UIElement でない場合は null

実装

Windows の要件

デバイス ファミリ
Windows 10, version 1809 (10.0.17763.0 で導入)
API contract
Windows.Foundation.UniversalApiContract (v7.0 で導入)

注釈

DataTemplate は、テンプレートで宣言された要素オブジェクトを生成するファクトリとして機能します。 呼び出されるたびに新しいインスタンスを作成する LoadContent メソッドとは異なり、GetElement メソッドは、新しいインスタンスを作成するか、 RecycleElement 経由でリサイクルされた既存のインスタンスを返すことができます。

DataTemplate の GetElement の実装では、ElementFactoryGetArgsData 値は使用されません。 Data プロパティは、DataTemplateSelector などの実装用に存在します。このプロパティは、コンテンツを読み込む DataTemplate の決定に使用されます。

適用対象

こちらもご覧ください