C# 设置、删除、读取Word文档背景——基于Spire.Cloud.Word
程序员文章站
2022-05-29 09:20:03
Spire.Cloud.Word.Sdk提供了接口SetBackgroudColor()、SetBackgroudImage()、DeleteBackground()、GetBackgroudColor()用于设置、删除及读取Word文档背景。本文将以C#程序为例演示如何来调用API接口实现以上内容 ......
spire.cloud.word.sdk提供了接口setbackgroudcolor()、setbackgroudimage()、deletebackground()、getbackgroudcolor()用于设置、删除及读取word文档背景。本文将以c#程序为例演示如何来调用api接口实现以上内容操作。
必要步骤:
步骤一:dll文件获取及导入。通过官网下载sdk文件包。
下载后,解压文件,将spire.cloud.word.sdk.dll文件及其他三个dll添加引用至vs程序(如下图);或者在程序中通过nuget搜索安装,直接导入。
步骤二:app id及key获取。在创建账号,并在“我的应用”板块中创建应用以获得app id及app key。
步骤三:源文档上传。在“文档管理”板块,上传源文档。这里如果想方便文档管理,可以新建文件夹,将源文档及结果文档分别保存至相应的文件夹下。不建文件夹时,源文档及结果文档直接保存在根目录。本文示例中,建了两个文件夹,分别用于存放源文档及结果文档。
【示例1】设置背景颜色
using spire.cloud.word; using spire.cloud.word.sdk.api; using spire.cloud.word.sdk.client; using spire.cloud.word.sdk.model; using system; namespace backgroundcolor { class program { static string appid = "app id"; static string appkey = "app key"; static void main(string[] args) { //配置账号信息 configuration wordconfiguration = new configuration(appid, appkey); //创建backgroundapi实例 backgroundapi backgroundapi = new backgroundapi(wordconfiguration); //源文档 var filename = "testfile.docx"; string name = filename; //源文档所在文件夹,若没有文件夹则设置为null string folder = "input"; //设置背景颜色rgb值 color color = new color(255, 255, 205); //设置文档密码,如果没有密码,则设置为null string password = null; //使用冰蓝云配置的2g空间存贮文档,可设置为null string storage = null; //设置生成文档的路径及文档名称 string destfilepath = "output/backgroundcolor.docx"; //调用方法设置背景颜色 backgroundapi.setbackgroudcolor(name,color, folder, storage, password, destfilepath); } } }
背景颜色设置结果:
【示例2】设置背景图片
using spire.cloud.word.sdk; using spire.cloud.word.sdk.api; using spire.cloud.word.sdk.client; using system; namespace backgroundimg { class program { static string appid = "app id"; static string appkey = "app key"; static void main(string[] args) { //配置账号信息 configuration wordconfiguration = new configuration(appid, appkey); //创建backgroundapi实例 backgroundapi backgroundapi = new backgroundapi(wordconfiguration); //源文档及图片 var filename = "testfile.docx"; var imagename = "ss.png"; string name = filename; //源文档所在文件夹,若没有文件夹则设置为null string folder = "input"; string imagepath = "input" + "/"+ imagename; //设置文档密码,如果没有密码,则设置为null string password = null; //使用冰蓝云配置的2g空间存贮文档,可设置为null string storage = null; //设置生成文档的路径及文档名称 string destfilepath = "output/backgroundimg.docx"; //调用方法设置背景 backgroundapi.setbackgroudimage(name, imagepath, folder, storage, password, destfilepath); } } }
背景图片设置效果:
【示例3】删除背景(包括背景颜色及背景图片)
using spire.cloud.word.sdk; using spire.cloud.word.sdk.api; using spire.cloud.word.sdk.client; using system; namespace deletebackground { class program { static string appid = "app id"; static string appkey = "app key"; static void main(string[] args) { //配置账号信息 configuration wordconfiguration = new configuration(appid, appkey); //创建backgroundapi实例 backgroundapi backgroundapi = new backgroundapi(wordconfiguration); //源文档 var filename = "backgroundimg.docx"; string name = filename; //源文档所在文件夹,若没有文件夹则设置为null string folder = "output"; //设置文档密码,如果没有密码,则设置为null string password = null; //使用冰蓝云配置的2g空间存贮文档,可设置为null string storage = null; //设置生成文档的路径及文档名称 string destfilepath = "output/deletebackground.docx"; //调用方法删除文档中背景 backgroundapi.deletebackground(name, password, folder, storage, destfilepath); } } }
文档背景删除效果:
【示例4】读取背景颜色
using spire.cloud.word.sdk.api; using spire.cloud.word.sdk.client; using spire.cloud.word.sdk.model; using system; namespace getbackground { class program { static string appid = "app id"; static string appkey = "app key"; static void main(string[] args) { //配置账号信息 configuration wordconfiguration = new configuration(appid, appkey); //创建backgroundapi实例 backgroundapi backgroundapi = new backgroundapi(wordconfiguration); //源文档 var filename = "backgroundcolor.docx"; string name = filename; //源文档密码,若无密码可设置为null string password = null; //源文档所在文件夹,若没有文件夹则设置为null string folder = "output"; //使用冰蓝云配置的2g空间存贮文档,可设置为null string storage = null; //获取文档背景色 system.console.writeline(backgroundapi.getbackgroudcolor(name, password, folder, storage)); system.console.readline(); } } }
背景色rgb值读取结果:
(本文完)