Parse

上次修改时间: 2010年12月1日

适用范围: SharePoint Foundation 2010

分析指定文档,并将其提取的文档属性写入指定属性包。

HRESULT Parse(
   ILockBytes *pilb,
   IParserPropertyBag *pibag,
   VARIANT_BOOL *pfChanged
);

参数

pilb

[输入] 要分析的文档。

pilbag

[输入] 分析程序要将文档属性写入其中的目标属性包对象。

pfChanged

[输出] 分析程序是否已更改文档。如果已更改,则为 True;否则为 False。

返回值

分析程序方法返回典型 HRESULT 值。通常,该分析程序在成功时应返回一个正 OK 值,或在失败时返回负 FAIL 值。

备注

Microsoft SharePoint Foundation 使用已为文档指定的任何文档属性预先填充它在 pilb 参数中传递的属性包对象。

分析程序执行此方法后,SharePoint Foundation 将会访问属性包并确定与文档的列匹配的属性。然后,它将提升那些属性,或者将文档属性值写入匹配的文档库列。SharePoint Foundation 仅提升与适用于文档的列相匹配的属性。

SharePoint Foundation 还会将完整的文档属性集存储至哈希表;使用 SPFile.Properties 属性,可通过编程方式来访问此哈希表。

如果分析程序按 pfChanged 参数指定的方式更改了文档,则 SharePoint Foundation 会将更新的文档上载至文档库。

有关详细信息,请参阅文档属性升级和降级

请参阅

概念

自定义文档分析程序

文档属性升级和降级

文档分析程序接口概述