PreserveIncludePictureField

LoadOptions.PreserveIncludePictureField property

获取或设置读取 Microsoft Word 格式时是否保留 INCLUDEPICTURE 字段。 默认值为错误的.

public bool PreserveIncludePictureField { get; set; }

评论

默认情况下，INCLUDEPICTURE 字段会转换为形状对象。如果您需要保留该字段（例如，希望以编程方式更新该字段），则可以覆盖此方法。但请注意，此方法在 Aspose.Words 中并不常见。使用此方法需自行承担风险。

一个可能的用例是使用 MERGEFIELD 作为子字段来动态更改图片的源 path 。在这种情况下，您需要在模型中保留 INCLUDEPICTURE。

例子

展示如何在加载文档时保留或丢弃 INCLUDEPICTURE 字段。

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

FieldIncludePicture includePicture = (FieldIncludePicture)builder.InsertField(FieldType.FieldIncludePicture, true);
includePicture.SourceFullName = ImageDir + "Transparent background logo.png";
includePicture.Update(true);

using (MemoryStream docStream = new MemoryStream())
{
    doc.Save(docStream, new OoxmlSaveOptions(SaveFormat.Docx));

    // 我们可以在 LoadOptions 对象中设置一个标志来决定是否转换所有 INCLUDEPICTURE 字段
    // 在加载包含它们的文档时将其转换为图像形状。
    LoadOptions loadOptions = new LoadOptions
    {
        PreserveIncludePictureField = preserveIncludePictureField
    };

    doc = new Document(docStream, loadOptions);

    if (preserveIncludePictureField)
    {
        Assert.True(doc.Range.Fields.Any(f => f.Type == FieldType.FieldIncludePicture));

        doc.UpdateFields();
        doc.Save(ArtifactsDir + "Field.PreserveIncludePicture.docx");
    }
    else
    {
        Assert.False(doc.Range.Fields.Any(f => f.Type == FieldType.FieldIncludePicture));
    }
}

也可以看看

LoadOptions.Password LoadOptions.ProgressCallback