在这个话题▼

文档附件

LEADTOOLS文档库提供以下支持附件:

阅读嵌入的附件

一些文件格式(如PDF)支持嵌入式文件附件。这些可以是任何二进制或文本数据嵌入在原始的文件中。在PDF格式的情况下,嵌入式文件附件可以其他PDF文档,PNG或TIF图像,文本文件,或任何其他数据。

解析文档中嵌入的附件,设置的值LoadDocumentOptions.LoadAttachmentsMode来AsAttachments和调用任何负载方法(如DocumentFactory.LoadFromFile或DocumentFactory.LoadFromUri)。由此产生的LEADDocument对象将有附件收集填充的属性嵌入附件发现在原始的文件中,连同中的每一项的类型作为一个集合DocumentAttachment。注意,此时每个附件的二进制数据(如嵌入式图像的JPEG数据在一个PDF),还没有加载。

其他属性的值DocumentAttachment设置如下:

财产	价值
DocumentAttachment.AttachmentNumber	基于嵌入式附件号码。
DocumentAttachment.DocumentId	零,因为这是一个嵌入的附件。
DocumentAttachment.IsEmbedded	真正的,因为这是一个嵌入的附件。
DocumentAttachment.FileName	附件的文件名。这是原始文档的解析,不会零。
DocumentAttachment.DisplayName	附件的显示名称。这是原始文档的解析和是可选的。
DocumentAttachment.FileLength	附件文件的长度字节。这是可选的。
DocumentAttachment.MimeType	附件文件的mime类型,如`图像/ jpeg`或`应用程序/ pdf`。这是可选的。
DocumentAttachment.Metadata	泛型字典的值特定于文件格式。例如,PDF文档的创建/修改日期将附件文件以及PDF对象数量。

指DocumentAttachment了一个例子。

注意:文档库使用RasterCodecs加载附件。指RasterCodecs.ReadAttachments在LEADTOOLS信息附件文件格式支持。

任何LEADDocument可以手动添加到另一个附件通过创建一个新实例的DocumentAttachment,设置对象的属性,并将其添加到主文档附件收集。必须设置以下属性:

财产	价值
DocumentAttachment.AttachmentNumber	必须设置为基于一个独特的价值来确定这个附件。
DocumentAttachment.DocumentId	必须设置附件文档的ID。
DocumentAttachment.IsEmbedded	必须设置为假,因为附件不是嵌入。

其余的属性可以设置(但不要求)与附件文档:

财产	价值
DocumentAttachment.FileName	可以设置为LEADDocument.Name。
DocumentAttachment.DisplayName	可以设置为LEADDocument.Name。
DocumentAttachment.FileLength	可以设置为LEADDocument.FileLength。
DocumentAttachment.MimeType	可以设置为LEADDocument.MimeType。
DocumentAttachment.Metadata	任何额外的特定于应用程序的值。

的价值LEADDocument.AutoDeleteAttachmentsFromCache控制处理外部附件文档当业主文档从缓存中删除。如果真正的(默认值),则文档工厂将尝试删除所有文档ID等于DocumentAttachment.DocumentId从缓存中,当DocumentFactory.DeleteFromCache被称为业主文档。

外部附件可以混合与嵌入的附件LEADDocument。

中设置的值LEADDocument.Attachments当业主保存LEADDocument从缓存中保存到然后持久化。应用程序可以在任何时候修改附件(例如,当添加、删除或重新排列的物品附件收集)。

嵌入式的数据或外部附件不加载时,所有者从缓存加载文档。只有DocumentAttachment属性(如AttachmentNumber和DocumentId)器。

使用DocumentFactory.LoadDocumentAttachment作为一个新的加载附件LEADDocument对象。这个对象是分离和独立的原始所有者的文档。LoadDocumentAttachment检查DocumentAttachment.DocumentId值:

当使用DocumentFactory.LoadDocumentAttachment嵌入的附件的价值DocumentAttachment.DocumentId总是零默认情况下从所有者文档和附件数据解析每次调用此方法。应用程序可以优化这个操作通过设置的值DocumentAttachment.DocumentId附件文档的ID。随后的调用DocumentFactory.LoadDocumentAttachment将参考这个值和从缓存中加载附件文档。有工厂自动从缓存中加载附件文档,设置的值LoadAttachmentOptions.UpdateAttachmentDocumentId来真正的在加载附件使用的选项。

使用DocumentAttachments.CreateAttachmentStream获取附件的二进制数据。该方法返回的数据作为一个低水平流。使用CreateAttachmentStream可能是有用的在某些情况下(例如,如果嵌入的附件不是一个文件格式,可以使用文档库加载,比如音频或视频文件)。

使用DocumentFactory.SaveAttachmentToCache将附件保存到缓存。该方法检查DocumentAttachment.DocumentId值,如果没有零将返回相同的文档ID,如果该值为零和IsEmbedded是真正的,那么AttachmentNumber用于标识嵌入的附件并尝试提取之前从所有者文档保存到缓存中。

帮助21.0.2021.11.1版本