WPF自定义FormContainer控件嵌套触发栈溢出问题排查与解决

问题原因 #

你自定义的FormContainer继承自ContentControl，同时将FormItems标记为内容属性，这就和ContentControl默认的Content内容属性产生了冲突。当嵌套使用控件时，XAML解析器会混淆子元素的归属：内部的FormContainer会被错误地当作外部控件的Content而非FormItems的子项，而ContentControl的Content又会被你的ControlTemplate重复处理，形成无限循环的控件加载、模板解析流程，最终触发栈溢出。

解决办法 #

1. 取消内容属性标记，显式指定子项归属 #

移除FormItems依赖属性上的[ContentProperty(nameof(FormItems))]特性，在XAML中通过<FormContainer.FormItems>标签明确包裹子元素，避免和ContentControl的Content属性冲突。
示例XAML：

<local:FormContainer>
    <local:FormContainer.FormItems>
        <TextBox Text="第一层输入框"/>
        <local:FormContainer>
            <local:FormContainer.FormItems>
                <TextBox Text="第二层输入框"/>
            </local:FormContainer.FormItems>
        </local:FormContainer>
    </local:FormContainer.FormItems>
</local:FormContainer>

2. 改用ItemsControl作为基类（推荐） #

既然你的核心需求是管理并展示一组子元素集合，直接继承ItemsControl更合理——它本身就是为处理子项集合设计的控件，天然支持嵌套，不会和Content属性产生冲突。
自定义控件代码示例：

public class FormContainer : ItemsControl
{
    static FormContainer()
    {
        DefaultStyleKeyProperty.OverrideMetadata(typeof(FormContainer), new FrameworkPropertyMetadata(typeof(FormContainer)));
        // 默认用StackPanel作为子项容器
        ItemsPanelProperty.OverrideMetadata(typeof(FormContainer), new FrameworkPropertyMetadata(typeof(StackPanel)));
    }
}

嵌套使用的XAML会更简洁，且无冲突：

<local:FormContainer>
    <TextBox Text="第一层输入框"/>
    <local:FormContainer>
        <TextBox Text="第二层输入框"/>
    </local:FormContainer>
</local:FormContainer>

3. 保留ContentControl，但隔离Content和FormItems（不推荐） #

如果必须继承ContentControl，需要确保ControlTemplate仅处理FormItems，完全隔离Content属性的逻辑。比如模板中的ItemsControl只绑定FormItems，不涉及Content：

<ControlTemplate TargetType="local:FormContainer">
    <StackPanel>
        <ItemsControl ItemsSource="{TemplateBinding FormItems}"/>
    </StackPanel>
</ControlTemplate>

但这种方式容易引发属性混淆，维护成本高，不如直接使用ItemsControl方案。

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