.NET MAUI XAML绑定警告：ViewModel中找不到结构体属性

以下是针对你遇到问题的排查和解决步骤：

1. 检查结构体属性的访问修饰符与命名大小写 #

XAML绑定是大小写敏感的，且只能访问公共成员：

• 确保CarTelemetryData结构体的engineRPM是公共属性（不是字段），且命名完全匹配绑定路径：

  public struct CarTelemetryData
  {
      // 注意：如果绑定用的是engineRPM，这里属性名必须完全一致，包括大小写
      public int engineRPM { get; set; }
      // 或者遵循C#命名规范用EngineRPM，绑定路径对应写Data.EngineRPM
  }
  

  如果调试输出提示“找不到属性'engineRPM'在类型'CarTelemetryData'”，大概率是属性名大小写不匹配或访问级别不对。

2. 确保ViewModel的Data属性正确触发通知 #

因为CarTelemetryData是值类型（结构体），每次更新必须重新赋值整个结构体，且Data属性要正确触发PropertyChanged：

public class YourViewModel : INotifyPropertyChanged
{
    private CarTelemetryData _data;
    // 必须是公共属性
    public CarTelemetryData Data
    {
        get => _data;
        set
        {
            _data = value;
            // 必须触发属性变更通知，参数要准确对应属性名
            OnPropertyChanged(nameof(Data));
        }
    }

    // 你的OnPropertyChanged实现
    public event PropertyChangedEventHandler PropertyChanged;
    protected void OnPropertyChanged(string propertyName)
    {
        PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
    }

    // 更新Data的方法示例：必须重新赋值整个结构体，而非修改内部属性
    private void UpdateTelemetry(CarTelemetryData newData)
    {
        Data = newData; // 这样才会触发通知，绑定才能感知到变化
    }
}

如果只是修改Data.engineRPM而不重新赋值Data，由于结构体是值类型，绑定无法感知到内部属性的变化（因为Data本身的“值”没有改变）。

3. 验证BindingContext的正确性 #

确保页面的BindingContext确实指向你的ViewModel实例：

• 在代码后台设置：

  public MainPage()
  {
      InitializeComponent();
      // 实例化你的ViewModel并赋值给BindingContext
      BindingContext = new YourViewModel();
  }
  

• 或在XAML中声明（需正确引用命名空间）：

  <ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
               xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
               xmlns:local="clr-namespace:YourAppNamespace.ViewModels"
               x:Class="YourAppNamespace.MainPage">
      <ContentPage.BindingContext>
          <local:YourViewModel />
      </ContentPage.BindingContext>
  
      <!-- 你的Label绑定 -->
      <Label Text="{Binding Data.engineRPM}" />
  </ContentPage>
  

  如果调试输出提示“找不到属性'Data'在类型'XXX'”，说明BindingContext没有正确设置，或者ViewModel的Data属性不是公共的。

4. 排除结构体绑定的特殊问题 #

如果以上步骤都没问题，可尝试把结构体属性提取到ViewModel中做测试：

public class YourViewModel : INotifyPropertyChanged
{
    // 新增一个直接暴露engineRPM的属性
    public int CurrentEngineRPM => Data.engineRPM;

    // 在Data更新时，同时触发CurrentEngineRPM的通知
    public CarTelemetryData Data
    {
        get => _data;
        set
        {
            _data = value;
            OnPropertyChanged(nameof(Data));
            OnPropertyChanged(nameof(CurrentEngineRPM));
        }
    }
}

然后XAML绑定改为{Binding CurrentEngineRPM}，如果能正常显示，说明是结构体绑定的路径解析问题，此时可检查是否有自定义类型转换器或结构体的特殊标记（比如[Serializable]不影响绑定，但确保没有其他特性干扰）。

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