管理文档属性
介绍
Microsoft Excel 提供了向电子表格文件添加属性的功能。这些文档属性提供了有用的信息,分为 2 个类别,详述如下。
- 系统定义(内置)属性:内置属性包含有关文档的一般信息,如文档标题、作者姓名、文档统计信息等。
- 用户定义(自定义)属性:最终用户以名称-值对的形式定义的自定义属性。
使用 Microsoft Excel 管理文档属性
Microsoft Excel 允许您以所见即所得的方式管理 Excel 文件的文档属性。请按照以下步骤打开特性Excel 2016 中的对话框。
- 来自文件菜单,选择信息.
选择信息菜单 |
---|
- 点击特性标题并选择“高级属性”。
单击高级属性选择 |
---|
- 管理文件的文档属性。
属性对话框 |
---|
在 Properties 对话框中,有不同的选项卡,如 General、Summary、Statistics、Contents 和 Customs。每个选项卡都有助于配置与文件相关的不同类型的信息。自定义选项卡用于管理自定义属性。 |
使用 Aspose.Cells 处理文档属性
开发人员可以使用 Aspose.Cells API 动态管理文档属性。此功能可帮助开发人员将有用的信息与文件一起存储,例如文件的接收、处理时间、时间戳等。
Aspose.Cells for .NET 直接在输出文件中写入API和Version Number的信息。例如,在将 Document 呈现为 PDF 时,将填充 Aspose.Cells for .NET应用值为“Aspose.Cells”的字段和PDF 制片人具有值的字段,例如“Aspose.Cells v17.9”。
请注意,您不能指示 Aspose.Cells for .NET 更改或从输出文档中删除此信息。
访问文档属性
Aspose.Cells API 支持两种类型的文档属性,内置的和自定义的。 Aspose.Cells'工作簿类表示一个 Excel 文件,并且与 Excel 文件一样,工作簿类可以包含多个工作表,每个工作表由工作表类,而工作表的集合由工作表集合班级。
使用工作表集合访问文件的文档属性,如下所述。
- 要访问内置文档属性,请使用工作表集合.BuiltInDocumentProperties.
- 要访问自定义文档属性,请使用工作表集合.CustomDocumentProperties.
这俩工作表集合.BuiltInDocumentProperties和工作表集合.CustomDocumentProperties返回的实例Aspose.Cells.Properties.DocumentPropertyCollection.这个集合包含Aspose.Cells.Properties.DocumentProperty对象,每个对象代表一个内置或自定义的文档属性。
如何访问属性取决于应用程序要求,即;通过使用属性的索引或名称文档属性集合如下例所示。
这Aspose.Cells.Properties.DocumentProperty类允许检索文档属性的名称、值和类型:
- 要获取属性名称,请使用文档属性.名称.
- 要获取属性值,请使用文档属性.值. 文档属性.值将值作为对象返回。
- 要获取属性类型,请使用文档属性.Type .这将返回其中一个财产种类枚举值。获得属性类型后,使用其中一种文档属性.ToXXX方法来获取适当类型的值而不是使用文档属性.值.这文档属性.ToXXX方法如下表所述。
成员名字 | 描述 | ToXXX方法 |
---|---|---|
布尔值 | 属性数据类型为布尔值 | 布尔型 |
日期 | 属性数据类型是 DateTime。请注意,Microsoft Excel 仅存储 日期部分,时间不能存储在这种类型的自定义属性中 |
截止时间 |
漂浮 | 属性数据类型为 Double | 加倍 |
数字 | 属性数据类型为 Int32 | ToInt |
细绳 | 属性数据类型为字符串 | 到字符串 |
添加或删除自定义文档属性
正如我们之前在本主题开头所述,开发人员无法添加或删除内置属性,因为这些属性是系统定义的,但可以添加或删除自定义属性,因为它们是用户定义的。
添加自定义属性
Aspose.Cells API暴露了添加的方法自定义文档属性集合类以便将自定义属性添加到集合中。这添加方法将属性添加到 Excel 文件并返回新文档属性的引用作为Aspose.Cells.Properties.DocumentProperty目的。
配置“内容链接”自定义属性
要创建链接到给定范围内容的自定义属性,请调用CustomDocumentPropertyCollection.AddLinkToContent方法并传递属性名称和来源。您可以使用文档属性.IsLinkedToContent财产。此外,还可以使用资源的财产文档属性班级。
我们在示例中使用一个简单的模板 Microsoft Excel 文件。工作簿有一个定义的命名范围标记我的范围这是指单元格值。
删除自定义属性
要使用 Aspose.Cells 删除自定义属性,请调用DocumentPropertyCollection.Remove方法并传递要删除的文档属性的名称。