为何CustomTaskPane抛出NullReferenceException异常？

嘿，我来帮你排查这个触发NullReferenceException的问题！先看你贴的核心代码：

CustomTaskPaneCollection CustomTaskPanes;
CustomTaskPane ct;
Pdfcontrol pdf = new Pdfcontrol();
ct = Globals.ThisDocument.CustomTaskPanes.Add(pdf, "Pdf");

最可能的问题根源 #

这个异常大概率是**Globals.ThisDocument为空**导致的，这里要区分VSTO的两种核心项目类型：

• 如果你的加载项是应用级（Add-in）项目：Globals.ThisDocument根本就不存在（它只对应文档级项目的当前文档对象），直接调用就会返回null，触发异常。
• 如果是文档级（Document-level）项目：那可能是你在文档还没完成初始化的时候就调用了Globals.ThisDocument（比如在非ThisDocument_Startup的事件里提前执行代码）。

针对性解决方案 #

如果你用的是应用级VSTO加载项 #

把代码里的Globals.ThisDocument换成Globals.ThisAddIn，这才是应用级加载项获取自定义任务窗格集合的正确方式，修改后的代码：

CustomTaskPane ct;
Pdfcontrol pdf = new Pdfcontrol();
// 替换成应用级加载项的CustomTaskPanes集合
ct = Globals.ThisAddIn.CustomTaskPanes.Add(pdf, "Pdf");
// 别忘了加上这句让任务窗格显示出来
ct.Visible = true;

如果你用的是文档级VSTO项目 #

1. 确保你的代码是在ThisDocument类的Startup事件中执行的，比如：

private void ThisDocument_Startup(object sender, System.EventArgs e)
{
    CustomTaskPane ct;
    Pdfcontrol pdf = new Pdfcontrol();
    ct = this.CustomTaskPanes.Add(pdf, "Pdf");
    ct.Visible = true;
}

2. 避免在文档未加载完成的时机调用Globals.ThisDocument，比如在自定义类的构造函数里直接调用。

额外排查小技巧 #

可以加个简单的null检查，快速定位到底是哪个对象为空：

Pdfcontrol pdf = new Pdfcontrol();
if (Globals.ThisDocument == null)
{
    MessageBox.Show("ThisDocument对象为空！");
    return;
}
if (pdf == null)
{
    MessageBox.Show("Pdfcontrol实例化失败！");
    return;
}
CustomTaskPane ct = Globals.ThisDocument.CustomTaskPanes.Add(pdf, "Pdf");

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