使用OpenXmlPowerTools转HTML遇Value cannot be null错误排查

是的，这些缺失的部件正是触发「Value cannot be null. Parameter name: part」错误的直接原因。

OpenXmlPowerTools的HtmlConverter在将Word文档转换为HTML时，会依赖文档的核心部件来解析格式、样式、编号等关键内容。你提到的几个部件各自承担着不可替代的功能：

• DocumentSettingsPart：存储文档全局设置（如打印选项、视图配置）
• FontTablePart：管理文档中使用的字体定义
• NumberingDefinitionPart：处理列表编号的规则和样式
• ThemePart：控制文档主题的颜色、字体、效果
• WebSettingsPart：存储网页相关的显示配置

浏览器能正常显示修改后的文档，是因为浏览器对Word文档的解析逻辑更宽松，不强制要求这些部件存在；但OpenXmlPowerTools的转换工具对文档结构的完整性要求更高，当它尝试访问这些缺失的部件时，会因获取到null值而抛出异常。

解决方法 #

在修改保存文档前，确保手动创建并添加这些缺失的部件，并为其初始化默认内容：

var mainPart = doc.MainDocumentPart;

// 添加并初始化DocumentSettingsPart
if (mainPart.DocumentSettingsPart == null)
{
    var settingsPart = mainPart.AddNewPart<DocumentSettingsPart>();
    settingsPart.Settings = new Settings(new DecimalNumber { Val = 2 });
}

// 添加并初始化FontTablePart
if (mainPart.FontTablePart == null)
{
    var fontPart = mainPart.AddNewPart<FontTablePart>();
    fontPart.FontTable = new FontTable();
}

// 添加并初始化NumberingDefinitionPart
if (mainPart.NumberingDefinitionPart == null)
{
    var numberingPart = mainPart.AddNewPart<NumberingDefinitionPart>();
    numberingPart.Numbering = new Numbering();
}

// 添加并初始化ThemePart
if (mainPart.ThemePart == null)
{
    var themePart = mainPart.AddNewPart<ThemePart>();
    themePart.Theme = new Theme(new ThemeElements(), new ObjectDefaults());
}

// 添加并初始化WebSettingsPart
if (mainPart.WebSettingsPart == null)
{
    var webSettingsPart = mainPart.AddNewPart<WebSettingsPart>();
    webSettingsPart.WebSettings = new WebSettings();
}

添加完成后再保存文档，即可避免转换时的null参数异常。

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