MAUI中设置RadioButton的IsChecked时触发System.ArgumentOutOfRangeException问题

核心错误原因 #

1. ViewModel中Sections是字段而非可绑定属性
   Xamarin.Forms数据绑定仅支持公共属性，你当前的Sections是List<string>类型的字段，UI无法通过绑定获取数据，导致单选按钮根本没有生成，SectionList.Children集合为空，直接访问索引0自然触发ArgumentOutOfRangeException。

2. 过早访问UI元素的子集合
   页面构造函数中，InitializeComponent()和设置BindingContext后，数据绑定与UI渲染并未立即完成，此时SectionList还没有生成任何RadioButton子元素，直接访问Children[0]必然报错。

分步修复方案 #

1. 修正ViewModel的Sections为可绑定属性

将Sections从字段改为公共get-only属性，确保UI能通过绑定获取数据：

// LandingViewModel.cs
public class LandingViewModel : BaseViewModel
{
    // 改为公共属性，静态数据用get-only即可
    public List<string> Sections { get; } = new List<string> { "Trending", "Popular", "Buy", "Rent" };

    // 添加选中项属性，用于MVVM模式下的单选按钮绑定
    private string _selectedSection;
    public string SelectedSection
    {
        get => _selectedSection;
        set => SetProperty(ref _selectedSection, value);
    }

    public LandingViewModel()
    {
        // 默认选中第一个Section
        if (Sections.Any())
            SelectedSection = Sections[0];
    }

    // 其余原有代码保持不变...
}

注：确保BaseViewModel已实现INotifyPropertyChanged接口，SetProperty方法用于通知UI属性变更

2. 移除构造函数中直接操作UI的代码

删除LandingPage构造函数中访问SectionList.Children[0]的代码，改用MVVM绑定实现默认选中：

// LandingPage.cs
public partial class LandingPage : ContentPage
{
    public LandingPage()
    {
        InitializeComponent();
        this.BindingContext = new LandingViewModel();
        // 移除下面这行错误代码
        // (SectionList.Children[0] as RadioButton).IsChecked = true;
    }
}

3. 在XAML中正确绑定单选按钮组

假设你的SectionList是StackLayout，通过BindableLayout绑定Sections，并关联SelectedSection实现选中状态同步：

<!-- LandingPage.xaml -->
<ContentPage xmlns="http://xamarin.com/schemas/2014/forms"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:local="clr-namespace:PropertyApp.ViewModel"
             x:Class="PropertyApp.View.LandingPage">
    <ContentPage.Resources>
        <!-- 添加字符串相等转换器，用于RadioButton的IsChecked绑定 -->
        <local:StringEqualsConverter x:Key="StringEqualsConverter" />
    </ContentPage.Resources>

    <StackLayout x:Name="SectionList" 
                 BindableLayout.ItemsSource="{Binding Sections}"
                 Orientation="Horizontal">
        <BindableLayout.ItemTemplate>
            <DataTemplate>
                <RadioButton GroupName="Sections"
                             Content="{Binding}"
                             IsChecked="{Binding Source={RelativeSource AncestorType={x:Type local:LandingViewModel}}, 
                                                 Path=SelectedSection, 
                                                 Mode=TwoWay,
                                                 Converter={StaticResource StringEqualsConverter},
                                                 ConverterParameter={Binding}}" />
            </DataTemplate>
        </BindableLayout.ItemTemplate>
    </StackLayout>

    <!-- 其余UI代码... -->
</ContentPage>

4. 实现字符串相等转换器

创建一个转换器，用于将SelectedSection与当前RadioButton的内容做比较，返回布尔值控制选中状态：

public class StringEqualsConverter : IValueConverter
{
    public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
    {
        return string.Equals(value?.ToString(), parameter?.ToString());
    }

    public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
    {
        return (bool)value ? parameter : Binding.DoNothing;
    }
}

关键说明 #

• 始终遵循MVVM模式，避免直接在代码后台操作UI元素，通过ViewModel属性绑定实现状态控制
• 数据绑定仅支持公共属性，字段无法被UI识别
• UI渲染是异步过程，不要在页面构造函数中直接访问未完成渲染的子元素集合

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