PdfXmpMetadata

概述

PdfXmpMetadata 是 Aspose.PDF FOSS 中用于 .NET 的一个类。继承自：IDictionary<string、XmpValue>。

对 PDF 文档的 XMP 元数据流提供字典式外观层。

此类提供 31 个方法，用于在 .NET 程序中处理 PdfXmpMetadata 对象。可用的方法包括：Add、BindPdf、Clear、Close、Contains、ContainsKey、CopyTo、GetEnumerator、GetNamespaceURIByPrefix、GetPrefixByNamespaceURI、GetXmpMetadata、PdfXmpMetadata，以及另外 4 个方法。所有公共成员在安装了 Aspose.PDF FOSS for .NET 包后，可供任何 .NET 应用程序访问。属性包括：Count、Document、ExtensionFields、IsFixedSize、IsReadOnly、IsSynchronized，以及另外 3 项。

属性

名称	类型	访问	描述
`Document`	`Aspose.Pdf.Document`	读取	绑定到此外观的文档，已公开以便能够链入另一个外观。
`Count`	`int`	读取	当前已设置的元数据属性数量。
`IsReadOnly`	`bool`	读取	获取只读属性。
`IsFixedSize`	`bool`	读取	永远为假：调用者可能会添加和删除键。
`IsSynchronized`	`bool`	读取	真：此外观是单线程的；调用者自行序列化其访问。
`SyncRoot`	`object`	读取	返回的哨兵对象用于 SyncRoot 样式的锁定。
`Keys`	`ICollection<string>`	读取	绑定元数据中存在的所有属性键。
`Values`	`ICollection<XmpValue>`	读取	绑定元数据中存在的所有属性值。
`ExtensionFields`	`IDictionary<string, XmpPdfAExtensionSchema>`	读取	PDF/A 扩展字段，以扩展命名空间前缀为键。

方法

签名	描述
`PdfXmpMetadata()`	构建一个未绑定的外观。
`PdfXmpMetadata(document: Aspose.Pdf.Document)`	构建一个已绑定到文档的外观。
`BindPdf(path: string)`	通过路径绑定 PDF 文档，以便后续操作。
`BindPdf(input: Stream)`	绑定 PDF 流以进行后续操作。
`BindPdf(document: Aspose.Pdf.Document)`	将实时文档绑定，以便后续操作。
`BindPdf(inputPath: string, outputPath: string)`	通过路径绑定 PDF 文档，在稍后调用 Save() 时将其目标设为给定的输出路径。
`Save()`	将已绑定的文档及其所有 XMP 元数据编辑保存到由 BindPdf(string, string) 提供的输出路径，如未提供则回退到输入路径。
`Save(outputStream: Stream)`	将已绑定文档及其 XMP 编辑保存到流中。
`Save(outputFile: string)`	将带有 XMP 编辑的绑定文档保存到输出路径。
`Close()`	释放绑定文档/元数据（BindPdf / 保存 / 关闭生命周期）。
`Add(key: string, value: XmpValue)`	通过原始键添加属性。
`Add(key: string, value: object)`	通过原始键添加属性，并使用任意对象值。
`Add(key: DefaultMetadataProperties, value: XmpValue)`	通过已知的 DefaultMetadataProperties 键添加属性。
`Add(item: KeyValuePair<string, XmpValue>)`	添加键/值对（IDictionary 合约）。
`Add(xmpPdfAExtensionObject: XmpPdfAExtensionObject, namespacePrefix: string, namespaceUri: string, schemaDescription: string)`	在 namespacePrefix 下注册一个 PDF/A 扩展对象。
`Clear()`	从绑定的元数据中移除所有属性。
`Contains(key: string)`	是否绑定的元数据包含给定的原始键。
`Contains(property: DefaultMetadataProperties)`	是否绑定的元数据包含给定的已知属性。
`Contains(item: KeyValuePair<string, XmpValue>)`	是否绑定的元数据包含完全匹配的键/值对。
`ContainsKey(key: string)`	在此 PdfXmpMetadata 实例上调用 ContainsKey(key)。
`CopyTo(array: KeyValuePair<string, XmpValue>[], index: int)`	将所有键/值对复制到数组，从索引开始。
`GetEnumerator()`	在此 PdfXmpMetadata 实例上调用 GetEnumerator。
`GetNamespaceURIByPrefix(prefix: string)`	将已注册的前缀解析为其 XML 命名空间 URI，若不存在则返回 null。
`GetPrefixByNamespaceURI(namespaceURI: string)`	反向查找：将命名空间 URI 映射到其已注册的前缀，若不存在则返回 null。
`GetXmpMetadata()`	将整个绑定的 XMP 包序列化为 UTF-8 字节数组。
`GetXmpMetadata(name: string)`	仅将名为 name 的属性序列化为 UTF-8 字节数组。
`RegisterNamespaceURI(prefix: string, namespaceURI: string)`	注册一个 XML 命名空间前缀 → URI 映射。
`Remove(key: string)`	删除键处的属性；如果属性存在则返回 true。
`Remove(key: DefaultMetadataProperties)`	删除由众所周知的 DefaultMetadataProperties 键索引的属性。
`Remove(item: KeyValuePair<string, XmpValue>)`	如果当前存在，则删除完全相同的键/值对。
`TryGetValue(key: string, value: XmpValue)`	在此 PdfXmpMetadata 实例上调用 TryGetValue(key, value)。

另请参阅

Aspose.PDF for .NET — Enterprise API Reference