Xamarin ContentPage嵌套显示异常：Android端子页面内容未渲染

我明白你遇到的问题了——你自定义了PageViewContainer控件来嵌套ContentPage，Android端能渲染出子页面的容器框架，但里面的实际内容没显示出来。这是因为单纯获取子页面的渲染器实例还不够，我们需要手动触发页面内容的初始化、生命周期方法，同时正确完成渲染器的绑定和视图添加流程。

下面是具体的解决步骤和修改后的代码：

1. 优化宿主控件（可选但推荐） #

先给PageViewContainer添加属性变化的监听，确保子页面切换时能及时更新并处理生命周期：

using Xamarin.Forms;

namespace TestApp.Views.Controls
{
    [ContentProperty("Content")]
    public class PageViewContainer : View
    {
        public static readonly BindableProperty ContentProperty = BindableProperty.Create(
            nameof(Content), 
            typeof(ContentPage), 
            typeof(PageViewContainer),
            propertyChanged: OnContentChanged);

        public ContentPage Content
        {
            get { return (ContentPage)GetValue(ContentProperty); }
            set { SetValue(ContentProperty, value); }
        }

        private static void OnContentChanged(BindableObject bindable, object oldValue, object newValue)
        {
            var container = (PageViewContainer)bindable;
            // 清理旧页面的生命周期
            if (oldValue is ContentPage oldPage)
            {
                oldPage.SendDisappearing();
            }
            // 触发新页面的生命周期
            if (newValue is ContentPage newPage)
            {
                newPage.SendAppearing();
            }
        }
    }
}

2. 修改Android渲染器，完整初始化子页面内容 #

原来的渲染器只创建了子页面的渲染器，但没有完成完整的初始化流程。修改后的代码如下：

using Xamarin.Forms;
using Xamarin.Forms.Platform.Android;
using TestApp.Views.Controls;
using Android.Content;
using System.ComponentModel;

[assembly: ExportRenderer(typeof(PageViewContainer), typeof(PageViewContainerRenderer))]
namespace TestApp.Renderers
{
    public class PageViewContainerRenderer : ViewRenderer<PageViewContainer, Android.Views.View>
    {
        private PageRenderer _childPageRenderer;

        public PageViewContainerRenderer(Context context) : base(context)
        {
        }

        protected override void OnElementChanged(ElementChangedEventArgs<PageViewContainer> e)
        {
            base.OnElementChanged(e);

            if (e.OldElement != null)
            {
                // 清理旧的子页面渲染器资源
                _childPageRenderer?.Dispose();
            }

            if (e.NewElement != null && e.NewElement.Content != null)
            {
                SetupChildPage(e.NewElement.Content);
            }
        }

        protected override void OnElementPropertyChanged(object sender, PropertyChangedEventArgs e)
        {
            base.OnElementPropertyChanged(sender, e);

            if (e.PropertyName == PageViewContainer.ContentProperty.PropertyName)
            {
                // 内容变更时重新初始化子页面
                _childPageRenderer?.Dispose();
                SetupChildPage(Element.Content);
            }
        }

        private void SetupChildPage(ContentPage childPage)
        {
            // 创建子页面的渲染器实例
            _childPageRenderer = (PageRenderer)Platform.CreateRenderer(childPage);
            
            // 触发渲染器的初始化流程，让它处理子页面的内容布局
            _childPageRenderer.ElementChanged(new ElementChangedEventArgs<Page>(null, childPage));
            
            // 将子页面的原生视图设置为当前控件的原生内容
            SetNativeControl(_childPageRenderer.View);
        }

        protected override void Dispose(bool disposing)
        {
            if (disposing)
            {
                _childPageRenderer?.Dispose();
                Element.Content?.SendDisappearing();
            }
            base.Dispose(disposing);
        }
    }
}

关键要点解释 #

• 生命周期触发：通过SendAppearing()和SendDisappearing()手动触发子页面的生命周期方法，确保页面内的绑定、内容初始化逻辑正常执行。
• 渲染器完整初始化：调用_childPageRenderer.ElementChanged()是核心步骤，这会让渲染器正式处理子页面的内容解析、布局渲染工作，而不是仅仅创建一个空的渲染器实例。
• 视图挂载：通过SetNativeControl()将子页面的原生视图挂载到当前控件的容器中，确保它能被系统渲染显示。
• 资源清理：在控件销毁或内容切换时及时释放旧渲染器资源，避免内存泄漏问题。

这样修改后，你的PageViewContainer就能在Android端正常渲染嵌套的ContentPage及其内部内容了。

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