C# WinForms动态创建Label遇NullReferenceException问题求助

问题 #

我开发了一个WinForms UI应用，原本通过以下代码正常创建Label：

private void InitializeCurrentPerlLabel() {
    currentPerlLabel = new System.Windows.Forms.Label();
    SuspendLayout();

    currentPerlLabel.AutoSize = true;
    currentPerlLabel.Location = new System.Drawing.Point(10, 10);
    currentPerlLabel.Name = "currentPerlLabel";
    currentPerlLabel.Size = new System.Drawing.Size(35, 35);
    currentPerlLabel.TabIndex = 0;
    currentPerlLabel.Font = new Font(Font, FontStyle.Bold);

    Controls.Add(currentPerlLabel);
    Name = "BBUI";
    ResumeLayout(false);
    PerformLayout();
}

在构造函数中调用InitializeCurrentPerlLabel()即可正常运行。

现在我希望通过JSON配置文件自动化创建各类控件，为此编写了测试用的BuildLabel方法：

private void BuildLabel(string name, Label label) {
    var data = Conf[name];
    label = new System.Windows.Forms.Label();

    SuspendLayout();

    label.AutoSize = data["autosize"];
    label.Location = new System.Drawing.Point(10, 10);
    label.Name = name;
    label.Size = new System.Drawing.Size(35, 35);
    label.TabIndex = 0;
    label.Font = new Font(Font, FontStyle.Bold);

    Controls.Add(label);
    Name = data["name"];
    ResumeLayout(false);
    PerformLayout();       
}

调用方式为BuildLabel("currentPerlLabel", currentPerlLabel);，代码编译正常，但运行时抛出System.NullReferenceException: Object reference not set to an instance of an object.异常。

堆栈信息如下：

System.NullReferenceException: Object reference not set to an instance of an object.
   at BBUI.CurrentPerlLabel_Redraw()
   at BBUI.DrawComponents()
   at BBUI.Form1_Load(Object sender, EventArgs e)
   at System.Windows.Forms.Form.OnLoad(EventArgs e)
   at System.Windows.Forms.Form.OnCreateControl()
   at System.Windows.Forms.Control.CreateControl(Boolean fIgnoreVisible)
   at System.Windows.Forms.Control.CreateControl()
   at System.Windows.Forms.Control.WmShowWindow(Message& m)
   at System.Windows.Forms.Control.WndProc(Message& m)
   at System.Windows.Forms.Form.WmShowWindow(Message& m)
   at System.Windows.Forms.NativeWindow.Callback(IntPtr hWnd, Int32 msg, IntPtr wparam, IntPtr lparam)

我并非熟练的C#开发者，希望得到帮助，了解如何通过引用正确初始化预声明的currentPerlLabel对象。

解决方案 #

问题核心 #

C#默认是值传递，你在BuildLabel方法里给label赋值new Label()，只是修改了方法内部的局部变量，完全没影响到外部的currentPerlLabel引用。外部的currentPerlLabel还是null，后续CurrentPerlLabel_Redraw()调用它时自然触发空引用异常。

修复方案 #

有两种常用方式让方法内部的赋值同步到外部变量：

方式1：用ref关键字传递引用

修改BuildLabel的参数声明，添加ref标记，让方法直接操作外部变量的引用：

private void BuildLabel(string name, ref Label label) {
    var data = Conf[name];
    // 这里的赋值会直接修改外部传入的currentPerlLabel
    label = new System.Windows.Forms.Label();

    SuspendLayout();

    label.AutoSize = data["autosize"];
    label.Location = new System.Drawing.Point(10, 10);
    label.Name = name;
    label.Size = new System.Drawing.Size(35, 35);
    label.TabIndex = 0;
    label.Font = new Font(Font, FontStyle.Bold);

    Controls.Add(label);
    Name = data["name"];
    ResumeLayout(false);
    PerformLayout();       
}

调用时也要加上ref：

BuildLabel("currentPerlLabel", ref currentPerlLabel);

方式2：让方法返回创建好的Label

如果不想用ref，可以让方法直接返回Label对象，再赋值给外部变量：

private Label BuildLabel(string name) {
    var data = Conf[name];
    Label label = new System.Windows.Forms.Label();

    SuspendLayout();

    label.AutoSize = data["autosize"];
    label.Location = new System.Drawing.Point(10, 10);
    label.Name = name;
    label.Size = new System.Drawing.Size(35, 35);
    label.TabIndex = 0;
    label.Font = new Font(Font, FontStyle.Bold);

    Controls.Add(label);
    Name = data["name"];
    ResumeLayout(false);
    PerformLayout();  

    return label;     
}

调用时直接赋值：

currentPerlLabel = BuildLabel("currentPerlLabel");

额外检查点 #

• 确保Conf[name]、data["autosize"]、data["name"]都不为null，可以加空值判断避免额外异常：

  var data = Conf[name];
  if (data == null) throw new ArgumentException($"找不到配置项 {name}");
  

• 检查CurrentPerlLabel_Redraw()方法，确认它是在currentPerlLabel初始化完成后才被调用的。

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