运行时自定义用户控件无法添加至TableLayoutPanel问题求助

看起来你遇到的问题很典型——逻辑上控件已经添加到表格，但自定义控件就是不显示，换成原生Label就正常。我来帮你梳理几个最可能的原因和解决办法：

一、先排查自定义控件本身的问题 #

自定义控件不显示，大概率是它自己的布局或初始化有问题，先单独验证它能不能正常显示：

• 单独测试控件：新建一个空白窗体，直接拖一个GridSquareControl上去运行，如果它还是看不见，那问题出在控件内部：
  1. 检查控件的Visible属性是否被设为false（默认是true，但可能不小心改了）。
  2. 确认内部三个Label已经正确添加到控件的Controls集合里，并且设置了合适的布局属性（比如Dock=Fill、Anchor=Top|Bottom|Left|Right），不然Label可能缩成看不见的状态。
  3. 检查控件的尺寸设置：如果AutoSize=true但内部Label没有内容，控件会缩成0x0的尺寸。可以给控件设一个固定Size（比如new Size(50,50)），或者在构造函数里给内部Label赋值文本，让控件能自动撑开。
• 检查构造函数逻辑：确保传入的GridSquareModel被正确处理，比如给内部Label设置了文本内容。举个例子：

public GridSquareControl(GridSquareModel model)
{
    InitializeComponent();
    // 给内部Label赋值，确保控件有可见内容
    label1.Text = $"Pos: {model.Position.X},{model.Position.Y}";
    // 让控件填充单元格
    this.Dock = DockStyle.Fill;
}

二、检查TableLayoutPanel的配置 #

如果控件本身能正常显示，那问题可能在表格的布局设置上：

• 确认表格本身能显示：检查GridTable的Dock属性是否设为Fill，不然表格可能缩在窗体角落看不见。
• 修正行列样式：如果表格的ColumnStyles或RowStyles是AutoSize，而自定义控件尺寸为0，单元格也会跟着缩成0。建议把行列都设为Percent，均匀分配空间：
  可以在窗体设计器里设置，也可以在代码里添加：

private void RenderGrid(List<GridSquareModel> grid)
{
    UIGrid.Clear();
    GridTable.Controls.Clear();
    
    // 重置行列样式，确保每个单元格占1/8的空间
    GridTable.ColumnStyles.Clear();
    GridTable.RowStyles.Clear();
    for (int i = 0; i < 8; i++)
    {
        GridTable.ColumnStyles.Add(new ColumnStyle(SizeType.Percent, 12.5F));
        GridTable.RowStyles.Add(new RowStyle(SizeType.Percent, 12.5F));
    }
    
    foreach (var item in grid)
    {
        var control = new GridSquareControl(item) { Dock = DockStyle.Fill };
        // 临时设置背景色，方便确认控件是否被添加
        control.BackColor = Color.LightBlue;
        GridTable.Controls.Add(control, item.Position.X, item.Position.Y);
    }
}

三、调试验证控件是否真的被添加 #

在代码里加一行调试代码，确认控件数量是否正确：

// 在RenderGrid方法末尾添加
Console.WriteLine($"已添加控件数量：{GridTable.Controls.Count}");

如果输出是64，说明控件已经成功添加，只是因为尺寸或布局问题看不见；如果数量不对，再检查item.Position.X/Y的取值是否在0-7范围内（TableLayoutPanel的行列索引从0开始）。

最后总结 #

按这个顺序排查：先确认自定义控件本身能显示→再检查表格的布局设置→最后验证控件是否被正确添加，基本上就能解决问题了。

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