.NET Maui应用因[ObservableProperty]陷入无限循环的解决方法

问题描述 #

开发的.NET Maui应用用于实现摄氏度与华氏度的相互转换，使用[ObservableProperty]特性后，更新其中一个属性时会触发另一个属性的更新，进而触发对方的变更回调，导致程序陷入无限循环。

原XAML标记 #

<VerticalStackLayout Margin="10,30,20,10">
    <Grid Background="Azure">
        <Grid.ColumnDefinitions>
            <ColumnDefinition Width="20" />
            <ColumnDefinition Width="150" />
            <ColumnDefinition Width="200" />
            <ColumnDefinition Width="*" />
            <ColumnDefinition Width="1200" >                    
          </ColumnDefinition>
        </Grid.ColumnDefinitions>
        <Grid.RowDefinitions>
              <RowDefinition Height="50" />
              <RowDefinition Height="50" />
              <RowDefinition Height="50" />
              <RowDefinition Height="50" />
              <RowDefinition Height="50" />
        </Grid.RowDefinitions>

        <Label Grid.Row="1"
                 Grid.Column="1"
                 Text="Celcius" 
                 VerticalTextAlignment="Center"
                 HorizontalTextAlignment="Start">
        </Label>
        <Entry Grid.Row="2"
                 Grid.Column="1"
                 Text ="{Binding Celsius}"                 
                 VerticalTextAlignment="Center"
                 HorizontalTextAlignment="Start">                
        </Entry>
        <Label Grid.Row="3"
                 Grid.Column="1"
                 Text="Fahrenheit" VerticalTextAlignment="Center"
                 HorizontalTextAlignment="Start">    
        </Label>
        <Entry Grid.Row="4"
                 Grid.Column="1"
                 Text ="{Binding Fahrenheit}"  
                 VerticalTextAlignment="Center"
                 HorizontalTextAlignment="Start">
        </Entry>      
    </Grid>
</VerticalStackLayout>

解决方案 #

核心思路 #

避免无限循环的关键是：仅当计算后的目标属性值与当前值不一致时，才执行更新操作，同时要处理输入不合法的情况（比如空字符串、非数字输入），防止double.Parse抛出异常。

修改后的视图模型代码 #

public partial class TemperaturePageViewModel : ObservableObject
{        
    [ObservableProperty]
    private string _fahrenheit;

    [ObservableProperty]
    private string _celsius;

    partial void OnFahrenheitChanged(string value)
    { 
        // 处理空值或非数字输入
        if (!double.TryParse(value, out double fahrenheitValue))
        {
            Celsius = string.Empty;
            return;
        }

        // 修正计算公式：正确的摄氏度转换应为 (华氏度 - 32) / 1.8
        var celsiusResult = (fahrenheitValue - 32) / 1.8;
        // 格式化字符串，避免因浮点数精度问题导致的频繁更新
        var celsiusStr = celsiusResult.ToString("0.##");
        
        // 仅当值不同时才更新，切断循环触发链条
        if (Celsius != celsiusStr)
        {
            Celsius = celsiusStr;
            Console.WriteLine($"Celsius = {celsiusResult}"); 
        }
    } 

    partial void OnCelsiusChanged(string value)
    {     
        // 处理空值或非数字输入
        if (!double.TryParse(value, out double celsiusValue))
        {
            Fahrenheit = string.Empty;
            return;
        }

        // 计算华氏度
        var fahrenheitResult = (celsiusValue * 1.8) + 32;
        // 格式化字符串，避免因浮点数精度问题导致的频繁更新
        var fahrenheitStr = fahrenheitResult.ToString("0.##");
        
        // 仅当值不同时才更新，切断循环触发链条
        if (Fahrenheit != fahrenheitStr)
        {
            Fahrenheit = fahrenheitStr;
            Console.WriteLine($"Fahrenheit = {fahrenheitResult}");  
        }
    }
}

额外优化说明 #

• 输入合法性校验：用double.TryParse替代double.Parse，避免用户输入无效内容时程序崩溃。
• 修正转换公式：原代码中华氏度转摄氏度的公式错误，已调整为正确的(华氏度 - 32) / 1.8。
• 数值格式化：用"0.##"格式化结果，保留两位小数，避免因浮点数精度问题（比如计算后得到25.0000000001）导致的不必要属性更新。
• 值判断逻辑：更新前对比目标值与当前属性值，只有不同时才执行赋值，彻底切断循环触发的链条。

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