.NET MAUI自定义组件无法同步属性值至ViewModel求助

以下是导致嵌套属性（如PhoneNumber对象、FullName）无法同步回ViewModel的常见原因及排查解决方法：

1. 未实现INotifyPropertyChanged接口 #

ViewModel、嵌套的PhoneNumber类及包含FullName的类，都必须实现INotifyPropertyChanged接口（或继承ObservableObject这类封装好的基类）。否则属性变更无法双向通知，UI输入无法同步回ViewModel。

• 排查点：检查相关类是否正确实现属性变更通知逻辑。
• 示例代码：

  public class PhoneNumber : ObservableObject
  {
      private string _countryCode;
      public string CountryCode
      {
          get => _countryCode;
          set => SetProperty(ref _countryCode, value);
      }
  
      // 区号、号码属性需同理实现
  }
  
  public class MainViewModel : ObservableObject
  {
      private PhoneNumber _phone;
      public PhoneNumber Phone
      {
          get => _phone;
          set => SetProperty(ref _phone, value);
      }
  
      private string _fullName;
      public string FullName
      {
          get => _fullName;
          set => SetProperty(ref _fullName, value);
      }
  }
  

2. 绑定模式未设置为TwoWay #

默认绑定模式若为OneWay，仅会从ViewModel同步到UI，不会反向同步。需确保自定义组件内部控件及组件自身的绑定模式为TwoWay。

• 排查点：检查XAML中输入控件（如Entry）的绑定，以及使用自定义组件时的绑定是否指定Mode=TwoWay。
• 示例代码：

  <!-- 自定义ContentView内部的Entry绑定 -->
  <Entry Text="{Binding CountryCode, Mode=TwoWay}" />
  
  <!-- 页面中使用自定义组件的绑定 -->
  <local:PhoneNumberView Phone="{Binding Phone, Mode=TwoWay}" />
  

3. 自定义ContentView的绑定属性定义错误 #

若自定义组件通过BindableProperty暴露绑定属性（如PhoneProperty），需确保属性类型匹配，且默认绑定模式设为TwoWay。

• 排查点：检查绑定属性的注册代码，确认默认模式设置正确。
• 示例代码：

  public static readonly BindableProperty PhoneProperty =
      BindableProperty.Create(
          nameof(Phone), 
          typeof(PhoneNumber), 
          typeof(PhoneNumberView),
          defaultBindingMode: BindingMode.TwoWay);
  
  public PhoneNumber Phone
  {
      get => (PhoneNumber)GetValue(PhoneProperty);
      set => SetValue(PhoneProperty, value);
  }
  

4. 嵌套对象未初始化 #

若ViewModel中的PhoneNumber对象为null，UI无法绑定到其属性，输入自然无法同步。需在ViewModel初始化时实例化嵌套对象。

• 排查点：检查ViewModel构造函数，确认嵌套对象已被实例化。
• 示例代码：

  public MainViewModel()
  {
      Phone = new PhoneNumber();
  }
  

5. 绑定路径错误 #

自定义ContentView内部的绑定路径需匹配上下文：若组件的BindingContext是自身，需通过RelativeSource或控件引用绑定到组件的属性；若BindingContext是外部ViewModel，需确保路径指向正确的嵌套属性。

• 示例代码（绑定到组件自身的Phone属性）：

  <ContentView x:Name="ThisView">
      <Entry Text="{Binding Phone.CountryCode, Mode=TwoWay}"
             BindingContext="{x:Reference ThisView}" />
  </ContentView>
  

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