DataTemplateSelector 類別

定義

命名空間:

Microsoft.Maui.Controls

組件:

Microsoft.Maui.Controls.dll

來源:

DataTemplateSelector.cs

依資料類型和容器選取 DataTemplate 物件。

public ref class DataTemplateSelector abstract : Microsoft::Maui::Controls::DataTemplate

public abstract class DataTemplateSelector : Microsoft.Maui.Controls.DataTemplate

type DataTemplateSelector = class
    inherit DataTemplate

Public MustInherit Class DataTemplateSelector
Inherits DataTemplate

繼承

Object

ElementTemplate

DataTemplate

DataTemplateSelector

備註

應用程式開發人員會覆寫 OnSelectTemplate(Object, BindableObject) 方法，以針對資料類型和父容器組合傳回唯 DataTemplate 一的 。 此外，由於針對連續呼叫 SelectTemplate(Object, BindableObject)的指定數據片段，必須傳回相同的確切範本實例，因此開發人員應該在其建構函式覆寫中建立並儲存這些 DataTemplate 實例。

開發人員應該注意下列專案：

• OnSelectTemplate 不得傳回另一個 DataTemplateSelector 和 ：
• Android 平臺限制為每個清單檢視 20 個範本。：

下列範例顯示基本用途：

class MyDataTemplateSelector : DataTemplateSelector
{
    public MyDataTemplateSelector ()
    {
        // Retain instances
        this.templateOne = new DataTemplate (typeof (ViewA));
        this.templateTwo = new DataTemplate (typeof (ViewB));
    }

    protected override DataTemplate OnSelectTemplate (object item, BindableObject container)
    {
        if (item is double)
            return this.templateOne;
        return this.templateTwo;
    }

    private readonly DataTemplate templateOne;
    private readonly DataTemplate templateTwo;
}

建構函式

DataTemplateSelector()

依資料類型和容器選取 DataTemplate 物件。

屬性

Bindings	取得繫結的字典，字典是依繫結的屬性編製索引。 (繼承來源 DataTemplate)
LoadTemplate	依資料類型和容器選取 DataTemplate 物件。 (繼承來源 ElementTemplate)
Values	為這個 DataTemplate 傳回依屬性編製索引的屬性值字典。 (繼承來源 DataTemplate)

方法

CreateContent()	由 XAML 基礎結構用來載入資料範本及設定結果 UI 的內容。 (繼承來源 ElementTemplate)
OnSelectTemplate(Object, BindableObject)	依資料類型和容器選取 DataTemplate 物件。
SelectTemplate(Object, BindableObject)	呼叫 OnSelectTemplate(Object, BindableObject) 並確認其結果，以傳回 item 的 DataTemplate。
SetBinding(BindableProperty, BindingBase)	設定 property 的繫結。 (繼承來源 DataTemplate)
SetValue(BindableProperty, Object)	設定 property 的值。 (繼承來源 DataTemplate)

明確介面實作

IDataTemplateController.Id	依資料類型和容器選取 DataTemplate 物件。 (繼承來源 DataTemplate)
IDataTemplateController.IdString	依資料類型和容器選取 DataTemplate 物件。 (繼承來源 DataTemplate)

擴充方法

CreateContent(DataTemplate, Object, BindableObject)	供 Microsoft.Maui.Controls 平台內部使用。
SelectDataTemplate(DataTemplate, Object, BindableObject)	供 Microsoft.Maui.Controls 平台內部使用。
SetBinding(DataTemplate, BindableProperty, String)	將 self 物件的 targetProperty 繫結至使用 path 建立的新 Binding 執行個體。