WinUI中ListView的DataTemplate内自定义控件绑定问题：能否使用及失效原因

是否允许在DataTemplate中使用自定义UserControl？ #

完全允许，这是WinUI里复用UI组件、优化代码结构的常规操作，你的用法本身没有问题。

绑定失效的核心原因及解决办法 #

外部TextBlock绑定正常，说明ListView的DataContext传递、AppBase模型的属性都是有效的，问题出在UpdateBlockControl的实现上，常见原因如下：

1. 未将AppName和ImageSource定义为依赖属性 #

UserControl要支持数据绑定，对外暴露的绑定属性必须是依赖属性，普通CLR属性无法被WinUI的绑定系统识别和更新。

如果你的自定义控件代码里是这样定义属性的（错误示例）：

public string AppName { get; set; }
public string ImageSource { get; set; }

这种写法会导致绑定无法生效，必须改成依赖属性：

// AppName 依赖属性
public static readonly DependencyProperty AppNameProperty =
    DependencyProperty.Register(
        nameof(AppName),
        typeof(string),
        typeof(UpdateBlockControl),
        new PropertyMetadata(string.Empty)
    );

public string AppName
{
    get => (string)GetValue(AppNameProperty);
    set => SetValue(AppNameProperty, value);
}

// ImageSource 依赖属性
public static readonly DependencyProperty ImageSourceProperty =
    DependencyProperty.Register(
        nameof(ImageSource),
        typeof(string),
        typeof(UpdateBlockControl),
        new PropertyMetadata(string.Empty)
    );

public string ImageSource
{
    get => (string)GetValue(ImageSourceProperty);
    set => SetValue(ImageSourceProperty, value);
}

2. 内部x:Bind的默认模式限制 #

WinUI中{x:Bind}默认使用OneTime模式，仅在控件初始化时绑定一次。如果AppBase的属性是异步加载或后续会更新，内部TextBlock就会显示为空。

修改内部绑定为OneWay模式即可解决：

<StackPanel Orientation="Vertical">
    <TextBlock Text=":-)"/>
    <TextBlock Text="{x:Bind AppName, Mode=OneWay}"/>
    <TextBlock Text="{x:Bind ImageSource, Mode=OneWay}"/>
</StackPanel>

3. 额外排查点 #

如果以上两步都做了还是无效，可以检查：

• 自定义控件的代码中是否手动设置了DataContext = this;（虽然不影响属性绑定，但可能干扰其他逻辑）；
• 在依赖属性的PropertyChangedCallback中添加日志，确认是否接收到了绑定的值：

  // 定义依赖属性时添加回调
  new PropertyMetadata(string.Empty, OnAppNameChanged)
  
  private static void OnAppNameChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
  {
      // 打印日志验证值是否传递过来
      System.Diagnostics.Debug.WriteLine($"AppName updated to: {e.NewValue}");
  }
  

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