C# 设置、删除、读取Word文档背景——基于Spire.Cloud.Word

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值读取结果：

 

 

（本文完）