Xamarin.Forms中切换ContentView内容后矩形圆角丢失问题排查

问题现象 #

• 创建了RadiusX和RadiusY均为20的矩形视图；
• 首次将该矩形赋值给ContentView，圆角显示正常；
• 将ContentView的内容替换为其他视图后，再次把原矩形赋值回去，矩形的圆角效果完全消失。

复现代码 #

using Xamarin.Forms;

namespace App
{
    public class SamplePage : ContentPage
    {
        public SamplePage()
        {
            var grid = new Grid
            {
                RowDefinitions = new RowDefinitionCollection
                {
                    new RowDefinition { Height = GridLength.Auto },
                    new RowDefinition { Height = GridLength.Star }
                }
            };

            var btn = new Button { Text = "Replace the view!" };
            Grid.SetRow(btn, 0);
            grid.Children.Add(btn);

            var rect = new Xamarin.Forms.Shapes.Rectangle
            {
                RadiusX = 20,
                RadiusY = 20,
                Fill = Brush.Azure,
                StrokeThickness = 3,
                Stroke = Brush.Black
            };

            var cv = new ContentView { Content = rect };
            Grid.SetRow(cv, 1);
            grid.Children.Add(cv);

            btn.Clicked += (_, __) =>
            {
                cv.Content = new Label();
                cv.Content = rect;
            };

            Content = grid;
        }
    }
}

效果对比 #

问题原因 #

这是Xamarin.Forms 5.0.0.2515版本的已知渲染bug：当Shape（如Rectangle）从可视化树中被移除时，其渲染层的圆角相关状态会被错误重置；当该视图再次被添加回可视化树时，框架没有重新读取并应用RadiusX/RadiusY的属性值，导致圆角失效。

解决方法 #

1. 手动重置圆角属性：在重新赋值前，显式重新设置RadiusX和RadiusY，强制框架更新渲染状态：

btn.Clicked += (_, __) =>
{
    cv.Content = new Label();
    // 重新设置圆角属性
    rect.RadiusX = 20;
    rect.RadiusY = 20;
    cv.Content = rect;
};

2. 创建新视图实例：放弃复用原矩形，每次需要显示时创建新的Rectangle实例，避免状态残留问题：

btn.Clicked += (_, __) =>
{
    cv.Content = new Label();
    // 创建新的矩形实例
    cv.Content = new Xamarin.Forms.Shapes.Rectangle
    {
        RadiusX = 20,
        RadiusY = 20,
        Fill = Brush.Azure,
        StrokeThickness = 3,
        Stroke = Brush.Black
    };
};

3. 升级框架版本：该bug在Xamarin.Forms 5的后续更新版本中已被修复，升级到更高版本的Xamarin.Forms，或者迁移到.NET MAUI，可以彻底解决此类渲染状态异常问题。

内容的提问来源于stack exchange，提问作者Hadi Fooladi Talari