MAUI中使用Style绑定Label的Text属性运行时不更新问题

为Label应用了Style，并将其Text属性绑定到ViewModel中的SelectedItem属性。初始时Label文本通过ViewModel属性正常显示，之后通过x:name引用Label在按钮点击事件中直接修改了Text属性，文本随之更新。但当通过另一个按钮点击事件修改ViewModel中绑定的SelectedItem属性时，界面上的Label文本不再更新。

相关代码 #

MainPage.xaml #

<ContentPage.BindingContext>
    <local:ViewModel x:Name="vm" />
</ContentPage.BindingContext>
<ContentPage.Resources>
    <ResourceDictionary>
        <Style TargetType="Label"
               x:Key="CustomLabelStyle">
            <Setter Property="Text"
                    Value="{Binding SelectedItem,Mode=TwoWay,Source={x:Reference vm}}"></Setter>
        </Style>
    </ResourceDictionary>
</ContentPage.Resources>
<StackLayout x:Name="stack">
    <Button Text="set selected Item"
            Command="{Binding ListViewSelectionChangedCommand}"
            x:Name="btn"
            CommandParameter="{x:Reference label}"
            HeightRequest="50" />
    <Button Text="ChangeBinding"
            Clicked="Button_Clicked_1"
            x:Name="btn1" />
    <Label HeightRequest="50"
           Background="red"
           Style="{StaticResource CustomLabelStyle}"
           x:Name="label" />
</StackLayout>

ViewModel.cs #

public class ViewModel : INotifyPropertyChanged
{
    private string selectedItem;

    public string SelectedItem
    {
        get { return selectedItem; }
        set { 
            selectedItem = value;
            OnPropertyChanged(nameof(SelectedItem));
        }
    }
    public ICommand ListViewSelectionChangedCommand { get; set; }

    public ViewModel()
    {
        this.SelectedItem = "old value";
        ListViewSelectionChangedCommand = new Command(OnSelectionChanged);
    }

    private void OnSelectionChanged(object obj)
    {
        this.SelectedItem = "new value";
    }

    public event PropertyChangedEventHandler PropertyChanged;

    public void OnPropertyChanged(string name)
    {
        if (this.PropertyChanged != null)
            this.PropertyChanged(this, new PropertyChangedEventArgs(name));
    }
}

问题原因 #

直接通过控件实例设置Text属性时，会覆盖Style中Setter定义的绑定关系。在Xamarin.Forms/.NET MAUI的属性值优先级规则里，直接设置的属性值优先级高于Style Setter中的配置，这会导致原来的绑定被移除，后续ViewModel触发PropertyChanged事件时，无法再驱动Label的Text更新。

解决方案 #

方案1：始终通过ViewModel控制属性值（推荐） #

所有文本更新操作都通过修改ViewModel的SelectedItem属性实现，避免直接操作Label的Text属性，保持绑定关系的有效性，确保ViewModel与界面同步。

修改按钮点击事件Button_Clicked_1：

private void Button_Clicked_1(object sender, EventArgs e)
{
    vm.SelectedItem = "通过ViewModel更新的文本";
}

方案2：直接修改控件后恢复绑定 #

如果业务场景必须直接修改Label的Text，操作完成后需要重新恢复原有的绑定关系，让ViewModel的变更能再次触发界面更新：

private void Button_Clicked_1(object sender, EventArgs e)
{
    // 临时直接修改Text
    label.Text = "直接修改的文本";
    
    // 恢复原绑定
    label.SetBinding(Label.TextProperty, new Binding(nameof(ViewModel.SelectedItem), source: vm));
}

方案3：调整绑定定义位置 #

将Text属性的绑定直接定义在Label标签上，而非Style的Setter中，这样绑定关系更直观，后续维护也更方便：

<Label HeightRequest="50"
       Background="red"
       Style="{StaticResource CustomLabelStyle}"
       x:Name="label"
       Text="{Binding SelectedItem, Mode=TwoWay}" />

同时移除Style中关于Text属性的Setter配置。

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