共用方式為


DataTemplateSelector 類別

定義

依資料類型和容器選取 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
繼承
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) 並確認其結果,以傳回 itemDataTemplate

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 執行個體。

適用於