.NET MAUI中自定义ScrollViewRenderer导致内容消失的原因排查

你的问题核心在于：空的自定义兼容性渲染器没有执行基类的核心初始化逻辑，导致ScrollView的内容无法绑定到原生控件上，所以显示为空。

为什么会出现内容消失？ #

在Xamarin.Forms（以及.NET MAUI的兼容性渲染器体系）中，ScrollViewRenderer的OnElementChanged方法负责完成以下关键工作：

• 关联MAUI的ScrollView元素与Android原生的ScrollView控件
• 处理Content的加载与绑定
• 初始化控件的基础属性

你只实现了构造函数，没有重写并调用OnElementChanged的基类方法，这些核心逻辑完全没有执行，原生控件自然不会显示任何内容。

解决方案1：修复兼容性渲染器 #

如果要继续使用兼容性渲染器，必须重写OnElementChanged并调用基类实现，再添加自定义逻辑：

public class StyledScrollViewRenderer : ScrollViewRenderer
{
    public StyledScrollViewRenderer(Context context) : base(context)
    {
    }

    protected override void OnElementChanged(ElementChangedEventArgs<ScrollView> e)
    {
        // 必须调用基类方法，确保核心初始化逻辑执行
        base.OnElementChanged(e);

        // 在这里添加你的自定义样式逻辑，例如：
        // if (Control != null)
        // {
        //     Control.ScrollBarStyle = Android.Views.ScrollbarStyles.InsideOverlay;
        // }
    }
}

解决方案2：使用.NET MAUI原生Handler（推荐） #

兼容性渲染器是为迁移过渡设计的，.NET MAUI推荐使用Handler模式替代传统渲染器，更符合MAUI的架构设计：

1. 自定义ScrollView Handler #

#if ANDROID
using Microsoft.Maui.Platform;

public class StyledScrollViewHandler : ScrollViewHandler
{
    protected override void ConnectHandler(MauiScrollView platformView)
    {
        // 调用基类方法，保证核心功能正常
        base.ConnectHandler(platformView);

        // 添加你的自定义逻辑，例如修改滚动条样式：
        // platformView.ScrollBarStyle = Android.Views.ScrollbarStyles.InsideInset;
    }
}
#endif

2. 注册Handler到MAUI程序 #

builder
   .UseMauiApp<App>()
   ...
   .ConfigureMauiHandlers(handlers =>
   {
#if ANDROID
       handlers.AddHandler(typeof(ScrollView), typeof(StyledScrollViewHandler));
#endif
   })

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