本文介绍如何使用 NET REST API 更改 Word 文档的属性。我们将使用 Aspose.Words for .NET Cloud SDK 通过 C# 低代码 API 添加或更新 Word 文档属性。本文将指导您使用属性名称和新值添加新的自定义属性或更新现有的内置或自定义属性。
先决条件
- 创建帐户并获取 API 凭据
- 下载 Aspose.Words Cloud SDK for Dotnet to add or update Word document properties
- 使用上述 SDK 设置 C# 解决方案项目
使用 C# REST API 在 Word 中编辑文档属性的步骤
- 设置 API 的客户端 ID 和客户端密钥以修改 Word 属性
- 使用客户端凭据创建 WordsApi 类的对象
- 将源Word文件读入内存流并修改其属性
- 通过提供属性值创建 DocumentPropertyCreateOrUpdate 类对象
- 通过设置所需的属性来创建 CreateOrUpdateDocumentPropertyOnlineRequest 对象
- 调用 CreateOrUpdateDocumentPropertyOnline 方法来创建或更新属性
- 使用新的属性值保存输出 Word 文件
上述步骤描述了使用 C# REST API 修改文档属性的过程。首先创建 WordsApi 类对象,然后将源 Word 文件加载到内存流中。然后使用 DocumentPropertyCreateOrUpdate 对象定义新的属性参数,使用属性值和属性名称创建 CreateOrUpdateDocumentPropertyOnlineRequest,最后调用 CreateOrUpdateDocumentPropertyOnline 对象在加载的 Word 文件中添加或更新属性。
使用 C# 低代码 API 编辑文档属性的代码
using System; | |
using System.IO; | |
using Aspose.Words.Cloud.Sdk; | |
using Aspose.Words.Cloud.Sdk.Model; | |
using Aspose.Words.Cloud.Sdk.Model.Requests; | |
namespace WordsSample.Words | |
{ | |
public class WordFileProperties | |
{ | |
public void ChangeProperties() | |
{ | |
try | |
{ | |
var config = new Configuration { ClientId = "Id", | |
ClientSecret = "Secret" }; | |
var wordsApi = new WordsApi(config); | |
String output = "output.docx"; | |
using var requestDocument = File.OpenRead("Sample.docx"); | |
var requestProperty = new DocumentPropertyCreateOrUpdate(){Value = "Henry Jack"}; | |
var createRequest = new CreateOrUpdateDocumentPropertyOnlineRequest( | |
requestDocument, "Document reviewer", requestProperty, destFileName:output); | |
var task = wordsApi.CreateOrUpdateDocumentPropertyOnline(createRequest); | |
task.Wait(); | |
var result = task.Result; | |
if (result.Document.TryGetValue(output, out var stream)) | |
{ | |
stream.Position = 0; | |
using (var fileStream = File.Create(output)) | |
{ | |
stream.Seek(0, SeekOrigin.Begin); | |
stream.CopyTo(fileStream); | |
} | |
} | |
} | |
catch (Exception e) | |
{ | |
Console.WriteLine(e.Message); | |
} | |
} | |
} | |
} |
此示例代码演示了通过 C# 低代码 API* 使用 *Microsoft Word 属性。当我们创建 CreateOrUpdateDocumentPropertyOnlineRequest 对象时,我们提到 destFileName,它是在云上创建的结果输出文件的名称。处理文档属性后,使用相同的文件名下载输出文件以保存在磁盘上。
我们已经学会了使用 C# Low Code API 编辑文档属性。要从 Word 文件中读取注释,请参阅以下文章:使用 NET REST API 阅读 Word 文档中的评论。