我在解析一个 PPT 文档的时候,发现了这个 PPT 文档的背景色的透明度百分比的字符串里面包含了百分号,而不是一个 OpenXml 里面的百分比单位
这份 PPT 文档的背景内容如下
<p:bg>
<p:bgPr>
<a:solidFill>
<a:srgbClr val="383747">
<a:alpha val="100.00%" />
</a:srgbClr>
</a:solidFill>
</p:bgPr>
</p:bg>
可以看到背景的 a:alpha
的 Val 值是一个包含了百分号的字符串。这个和 OpenXML 的单位定义的百分比不相同,从 Office Open XML 的测量单位 可以了解到默认使用的是千分之一的百分比,也就是默认的字符串是一个整数的数值,其中数值的一千就代表百分之一的值,如我在 dotnetCampus.OpenXMLUnitConverter OpenXML 单位转换开源库 里面写的代码一样
如上面文档内容,如果使用 OpenXML SDK 的背景获取方式,如下面代码,将会提示出错
using (var presentationDocument = DocumentFormat.OpenXml.Packaging.PresentationDocument.Open("1.pptx", false))
{
var presentationPart = presentationDocument.PresentationPart;
var presentation = presentationPart.Presentation;
var slideIdList = presentation.SlideIdList;
foreach (var slideId in slideIdList.ChildElements.OfType<SlideId>())
{
SlidePart slidePart = (SlidePart)presentationPart.GetPartById(slideId.RelationshipId);
var slide = slidePart.Slide;
var background = slide.CommonSlideData.Background;
var backgroundProperties = background.BackgroundProperties;
var solidFill = backgroundProperties.GetFirstChild<SolidFill>();
var solidFillRgbColorModelHex = solidFill.RgbColorModelHex;
var alpha = solidFillRgbColorModelHex.GetFirstChild<Alpha>();
try
{
int alphaVal = alpha.Val;
}
catch (Exception e)
{
// Input string was not in a correct format.
Console.WriteLine(e);
}
}
}
以上的全部代码放在 github 欢迎下载测试,这里面就包含了这个测试的 PPT 文档
在 OpenXML SDK 里面将 alpha 的 Val 认为是一个 Int32Value 值,因此在转换的时候就会失败。这个问题我报给了官方,请看 OpenXML SDK will throw exception when a percentage with % char · Issue #875 · OfficeDev/Open-XML-SDK
咱的一个修复方法是获取的是 alpha 的 InnerText 然后进行转换
var alphaText = alpha.InnerText;
var percentage = new Percentage(alphaText);
public Percentage(string percentageText)
{
if (int.TryParse(percentageText, out var intValue))
{
IntValue = intValue;
return;
}
else
{
// 如果是带了百分比的
if (percentageText.Length > 1 && percentageText.EndsWith("%"))
{
var newPercentageText = percentageText.Substring(0, percentageText.Length - 1);
if (double.TryParse(newPercentageText, out var doubleValue))
{
IntValue = (int)Math.Round(doubleValue * 1000);
return;
}
}
}
throw new ArgumentException(
$"Can not convert PercentageText={percentageText} to {nameof(OpenXmlUnitConverter.Percentage)} value.");
}
而根据 ECMA 376 文档的定义,这里的 Alpha 值内容如下
<xsd:group name="EG_ColorTransform">
<xsd:choice>
<!-- 忽略代码 -->
<xsd:element name="alpha" type="CT_PositiveFixedPercentage" minOccurs="1" maxOccurs="1"/>
</xsd:choice>
</xsd:group>
而 CT_PositiveFixedPercentage 的定义如下
<xsd:complexType name="CT_PositiveFixedPercentage">
<xsd:attribute name="val" type="ST_PositiveFixedPercentage" use="required"/>
</xsd:complexType>
而 ST_PositiveFixedPercentage
的定义如下
<xsd:simpleType name="ST_PositiveFixedPercentage">
<xsd:union memberTypes="s:ST_PositiveFixedPercentage"/>
</xsd:simpleType>
这里的要求的数据格式如下
<xsd:simpleType name="ST_PositiveFixedPercentage">
<xsd:restriction base="ST_Percentage">
<xsd:pattern value="((100)|([0-9][0-9]?))(\.[0-9][0-9]?)?%"/>
</xsd:restriction>
</xsd:simpleType>
也就是说其实不算是 Int 数值
本文的属性是依靠 dotnet OpenXML 解压缩文档为文件夹工具 工具协助测试的,这个工具是开源免费的工具,欢迎小伙伴使用
本文会经常更新,请阅读原文: https://blog.lindexi.com/post/dotnet-OpenXML-%E4%BF%AE%E5%A4%8D-Office-%E6%96%87%E6%A1%A3%E9%87%8C%E9%9D%A2%E7%9A%84%E7%99%BE%E5%88%86%E6%AF%94%E5%86%85%E5%AE%B9%E5%8C%85%E5%90%AB%E7%99%BE%E5%88%86%E5%8F%B7.html ,以避免陈旧错误知识的误导,同时有更好的阅读体验。
如果你想持续阅读我的最新博客,请点击 RSS 订阅,推荐使用RSS Stalker订阅博客,或者收藏我的博客导航
本作品采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可。欢迎转载、使用、重新发布,但务必保留文章署名林德熙(包含链接: https://blog.lindexi.com ),不得用于商业目的,基于本文修改后的作品务必以相同的许可发布。如有任何疑问,请 与我联系 。
无盈利,不卖课,做纯粹的技术博客
以下是广告时间
推荐关注 Edi.Wang 的公众号
欢迎进入 Eleven 老师组建的 .NET 社区
以上广告全是友情推广,无盈利