Xamarin.Forms：ListView DataTemplate中自定义控件的变量绑定问题

看起来你已经搭好了自定义控件的基础框架——有ListView、动态DataTemplate，还定义了AttributeValues和EntityID的可绑定属性，接下来要做的就是在控件内部正确用上这个EntityID。我分几个常见场景给你具体的实现方案：

1. 先确认EntityID可绑定属性的定义（必做检查） #

首先确保你的EntityID可绑定属性定义是规范的，这是后续绑定的基础：

public class YourCustomControl : ContentView // 假设你的自定义控件继承自ContentView
{
    // 定义EntityID的可绑定属性
    public static readonly BindableProperty EntityIDProperty =
        BindableProperty.Create(
            nameof(EntityID),
            typeof(int), // 根据你的实际类型调整，比如string/Guid
            typeof(YourCustomControl),
            defaultValue: default(int),
            propertyChanged: OnEntityIDChanged); // 可选：属性变化时触发逻辑

    public int EntityID
    {
        get => (int)GetValue(EntityIDProperty);
        set => SetValue(EntityIDProperty, value);
    }

    // 可选：当EntityID变化时执行额外逻辑
    private static void OnEntityIDChanged(BindableObject bindable, object oldValue, object newValue)
    {
        var control = bindable as YourCustomControl;
        if (control != null)
        {
            // 比如刷新ListView、更新模板选择器等
            control.RefreshListViewIfNeeded();
        }
    }

    // 你的其他属性，比如AttributeValues
    public static readonly BindableProperty AttributeValuesProperty =
        BindableProperty.Create(nameof(AttributeValues), typeof(IEnumerable<YourAttributeModel>), typeof(YourCustomControl));

    public IEnumerable<YourAttributeModel> AttributeValues
    {
        get => (IEnumerable<YourAttributeModel>)GetValue(AttributeValuesProperty);
        set => SetValue(AttributeValuesProperty, value);
    }
}

2. 在自定义控件的代码后台使用EntityID #

如果是在控件的代码逻辑里（比如ListView的事件处理、数据处理）用到EntityID，直接访问this.EntityID即可：

private void ListView_ItemTapped(object sender, ItemTappedEventArgs e)
{
    var selectedAttr = e.Item as YourAttributeModel;
    if (selectedAttr != null)
    {
        // 示例：用EntityID和选中项做操作
        SubmitAttributeChange(EntityID, selectedAttr);
    }
}

3. 在自定义控件的XAML中绑定EntityID #

如果要在XAML元素（比如Label、Button，或者ListView的ViewCell内部）绑定EntityID，需要注意BindingContext的层级问题：

3.1 绑定到控件自身的元素（非ListView内部） #

给自定义控件的根元素加个x:Name，然后通过x:Reference绑定：

<ContentView xmlns="http://xamarin.com/schemas/2014/forms"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="YourNamespace.YourCustomControl"
             x:Name="thisControl"> <!-- 给控件本身命名 -->
    <StackLayout>
        <!-- 绑定控件的EntityID到Label -->
        <Label Text="Entity ID: {Binding EntityID, Source={x:Reference thisControl}}" />
        <ListView ItemsSource="{Binding AttributeValues, Source={x:Reference thisControl}}">
            <!-- ListView的模板定义 -->
        </ListView>
    </StackLayout>
</ContentView>

3.2 在ListView的ViewCell中绑定EntityID #

因为ViewCell的BindingContext是AttributeValues里的单个项，无法直接绑定控件的EntityID，这时候要用RelativeSource跳转到父级的自定义控件：

<ListView ItemsSource="{Binding AttributeValues, Source={x:Reference thisControl}}">
    <ListView.ItemTemplate>
        <DataTemplate>
            <ViewCell>
                <StackLayout Orientation="Horizontal">
                    <!-- 绑定当前列表项的Type字段 -->
                    <Label Text="{Binding Type}" />
                    <!-- 绑定自定义控件的EntityID -->
                    <Label Text="{Binding EntityID, Source={RelativeSource AncestorType={x:Type local:YourCustomControl}}}"
                           Margin="10,0,0,0" />
                </StackLayout>
            </ViewCell>
        </DataTemplate>
    </ListView.ItemTemplate>
</ListView>

注意：local是你自定义控件所在命名空间的前缀，记得在XAML顶部声明：xmlns:local="clr-namespace:YourNamespace"

4. 在DataTemplateSelector中使用EntityID #

如果你的动态模板选择逻辑需要用到EntityID，可以把Selector作为自定义控件的可绑定属性，然后在EntityID变化时同步给Selector：

首先定义模板选择器：

public class AttributeTemplateSelector : DataTemplateSelector
{
    // 新增EntityID属性用于模板选择逻辑
    public int EntityID { get; set; }

    // 定义不同类型的模板
    public DataTemplate TypeATemplate { get; set; }
    public DataTemplate TypeBTemplate { get; set; }
    public DataTemplate EntitySpecificTemplate { get; set; }

    protected override DataTemplate OnSelectTemplate(object item, BindableObject container)
    {
        var attrItem = item as YourAttributeModel;
        if (attrItem == null) return TypeATemplate;

        // 结合EntityID和Type选择模板
        if (attrItem.Type == "TypeB")
        {
            return TypeBTemplate;
        }
        else if (attrItem.Type == "TypeC" && EntityID == 100)
        {
            return EntitySpecificTemplate;
        }
        else
        {
            return TypeATemplate;
        }
    }
}

然后在自定义控件中添加Selector的可绑定属性，并同步EntityID：

public static readonly BindableProperty AttributeTemplateSelectorProperty =
    BindableProperty.Create(nameof(AttributeTemplateSelector), typeof(AttributeTemplateSelector), typeof(YourCustomControl));

public AttributeTemplateSelector AttributeTemplateSelector
{
    get => (AttributeTemplateSelector)GetValue(AttributeTemplateSelectorProperty);
    set => SetValue(AttributeTemplateSelectorProperty, value);
}

// 在EntityID变化时同步给Selector
private static void OnEntityIDChanged(BindableObject bindable, object oldValue, object newValue)
{
    var control = bindable as YourCustomControl;
    if (control?.AttributeTemplateSelector != null)
    {
        control.AttributeTemplateSelector.EntityID = (int)newValue;
        // 刷新ListView的模板（重新绑定数据源触发模板选择）
        control.YourListView.ItemsSource = null;
        control.YourListView.ItemsSource = control.AttributeValues;
    }
}

最后在XAML中配置Selector：

<local:YourCustomControl x:Name="thisControl">
    <local:YourCustomControl.AttributeTemplateSelector>
        <local:AttributeTemplateSelector>
            <local:AttributeTemplateSelector.TypeATemplate>
                <DataTemplate>
                    <!-- TypeA对应的ViewCell内容 -->
                </DataTemplate>
            </local:AttributeTemplateSelector.TypeATemplate>
            <local:AttributeTemplateSelector.TypeBTemplate>
                <DataTemplate>
                    <!-- TypeB对应的ViewCell内容 -->
                </DataTemplate>
            </local:AttributeTemplateSelector.TypeBTemplate>
        </local:AttributeTemplateSelector>
    </local:YourCustomControl.AttributeTemplateSelector>
</local:YourCustomControl>

关键注意点 #

• 确保可绑定属性的所有者类型是你的自定义控件（typeof(YourCustomControl)），否则绑定会失效。
• 当子元素的BindingContext和控件自身不同时（比如ListView的Item），必须用x:Reference或RelativeSource指定数据源。
• 如果EntityID变化需要影响UI，记得在propertyChanged回调中刷新相关元素（比如ListView的数据源）。

内容的提问来源于stack exchange，提问作者Andrej