欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页

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

程序员文章站 2024-01-29 17:12:46
...

Spire.Cloud.Word.Sdk提供了接口SetBackgroudColor()、SetBackgroudImage()、DeleteBackground()、GetBackgroudColor()用于设置、删除及读取Word文档背景。本文将以C#程序为例演示如何来调用API接口实现以上内容操作。

 

dll文件下载及导入:

步骤一: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();       
        }
    }
}

 

 

(本文完)