DataTemplate.GetElement(ElementFactoryGetArgs) メソッド

定義

名前空間:

Windows.UI.Xaml

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 のインスタンス。

戻り値

UIElement

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

実装

GetElement(ElementFactoryGetArgs)

Windows の要件

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

注釈

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

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

こちらもご覧ください

• IElementFactory
• DataTemplate.RecycleElement
• DataTemplateSelector.GetElement
• DataTemplateSelector.RecycleElement