C# 添加、删除、读取Word形状（基于Spire.Cloud.Word.SDK）

待我称王封你为后i 2023-01-13 04:18 233阅读 0赞

本文介绍调用Spire.Cloud.SDK for .NET 提供的接口shapesApi来操作Word形状，包括添加形状AddShape()，添加形状时，可设置形状类型、[颜色][Link 1]、大小、位置、倾斜、轮廓、文本环绕方式、顺序）；删除形状DeleteShape()和读取形状属性GetShapeProperties()等。调用接口方法及步骤参考以下步骤：

**步骤一：dll****文件获取及导入。**在程序中通过[Nuget搜索下载][Nuget]，直接导入所有dll。dll引用结果如下图所示：

![706090-20200618100058821-390527309.png][]

**步骤二：App ID****及Key****获取。**在“我的应用”板块中创建应用以获得App ID及App Key。

![706090-20200121161831973-1442624123.png][]

**步骤三：****源文档上传。**在“文档管理”板块，上传源文档。这里可以建文件夹，将文档存放在文件夹下。不建文件夹时，源文档及结果文档直接保存在根目录。本文示例中，建了两个文件夹，分别用于存放源文档及结果文档。（云平台提供免费1 万次调用次数和 2G 文档内存）

![706090-20200121161851330-849881235.png][]

**C\# 示例代码**

### **1.** **添加形状到****Word** ###

using System;
    using Spire.Cloud.Word.Sdk.Client;
    using Spire.Cloud.Word.Sdk.Api;
    using Spire.Cloud.Word.Sdk.Model;
    
    namespace AddShape
    {
        class Program
        {
            //配置AppID和AppKey
            static string appId = "App ID";
            static string appKey = "App Key";
            static string basePath = "https://api.e-iceblue.cn";
            static Configuration wordConfiguration = new Configuration(appId, appKey, basePath);
            static ShapesApi shapesApi = new ShapesApi(wordConfiguration);
            static void Main(string[] args)
            {           
                //实例化ShapesApi类
                ShapesApi shapesApi = new ShapesApi(wordConfiguration);
    
                string name = "test.docx";//源文档
                string paragraphPath = "sections/0/paragraphs/0";//段落路径
                int indexInParagraph = 1;//添加形状的段落
                string folder = "input";//源文档所在文件夹
                string storage = null;//使用冰蓝云配置的2G空间存贮文档，可设置为null
                string password = null;//源文档密码
    
                //设置形状属性（包括形状类型、位置、填充颜色、旋转方向、边框宽度/颜色、文本环绕类型/方式
                ShapeFormat shapeformat = new ShapeFormat(50, 50, ShapeFormat.ShapeTypeEnum.Star)
                {
                    HorizontalOrigin = ShapeFormat.HorizontalOriginEnum.Page,
                    VerticalOrigin = ShapeFormat.VerticalOriginEnum.Page,
                    VerticalPosition = 40,
                    HorizontalPosition = 230,
                    FillColor = new Color(255, 69, 0),
                    Rotation = 45,
                    StrokeWeight = 2,
                    StrokeColor = new Color(255, 255, 0),
                    TextWrappingType = ShapeFormat.TextWrappingTypeEnum.Both,
                    TextWrappingStyle = ShapeFormat.TextWrappingStyleEnum.InFrontOfText,
                    ZOrder = 1
                };
                string destFilePath = "output/AddShape.docx";//结果文档路径
    
                //调用方法添加形状
                shapesApi.AddShape(name,paragraphPath,shapeformat,destFilePath,folder,storage,indexInParagraph,password);
            }
        }
    }

形状添加效果：

![706090-20200121162000165-1319185217.png][]

**2.** **删除****Word****中的形状**

using System;
    using Spire.Cloud.Word.Sdk.Api;
    using Spire.Cloud.Word.Sdk.Client;
    
    
    namespace DeleteShape
    {
        class Program
        { 
            //配置AppID和AppKey
            static string appId = "App ID";
            static string appKey = "App Key";
            static string basePath = "https://api.e-iceblue.cn";
            static Configuration wordConfiguration = new Configuration(appId, appKey, basePath);
            static ShapesApi shapesApi = new ShapesApi(wordConfiguration);
            static void Main(string[] args)
            {          
                //实例化ShapesApi类
                ShapesApi shapesApi = new ShapesApi(wordConfiguration);
    
                string name = "AddShape.docx";//源文档
                string paragraphPath = "sections/0/paragraphs/0";//段落路径
                int index = 0;//要删除形状的索引
                string folder = "output";//源文档所在文件夹
                string storage = null;//使用冰蓝云配置的2G空间存贮文档，可设置为null
                string password = null;//源文档密码
    
                string destFilePath = "output/DeleteShape.docx";//结果文档路径
    
                //调用方法删除形状
                shapesApi.DeleteShape(name,paragraphPath,index,destFilePath,folder,storage,password);
            }
        }
    }

形状删除效果：

![706090-20200121162040362-1816009051.png][]

**3.** **读取Word****形状属性**

using System;
    using Spire.Cloud.Word.Sdk.Client;
    using Spire.Cloud.Word.Sdk.Api;
    
    
    namespace GetShapeProperties
    {
        class Program
        {
            //配置账号信息
            static string appId = "App ID";
            static string appKey = "App Key";
            static string basePath = "https://api.e-iceblue.cn";
            static Configuration wordConfiguration = new Configuration(appId, appKey, basePath);
            static ShapesApi shapesApi = new ShapesApi(wordConfiguration);
    
            static void Main(string[] args)
            {
                //实例化ShapesApi类
                ShapesApi shapesApi = new ShapesApi(wordConfiguration);
    
                string name = "AddShape.docx";//源文档
                string paragraphPath = "Section/0/Body/0/Paragraph/0";
                int index = 0;//读取的形状索引
                string folder = "output";//源文档所在文件夹
                string storage = null;//使用冰蓝云配置的2G空间存贮文档，可设置为null
                string password = null;//源文档密码
    
    
                //读取属性         
                System.Console.WriteLine(shapesApi.GetShapeFormat(name, paragraphPath, index, folder, storage, password));
                System.Console.ReadLine();
            }
        }
    }

属性读取结果：

![706090-20200121162207404-1203840398.png][]

（完）

[Link 1]: https://www.colorgg.com
[Nuget]: https://cloud.e-iceblue.cn/index.php/tutorials/cloud/webapi/net/nuget-spire-cloud-web-api
[706090-20200618100058821-390527309.png]: /images/20221022/c388693d2d3745fbbe06dd914d9cdd22.png
[706090-20200121161831973-1442624123.png]: /images/20221022/545ed8e451054bcb8f58553f98e44c38.png
[706090-20200121161851330-849881235.png]: /images/20221022/4e51d6b0de6d4e23b2def6fcb0887e7d.png
[706090-20200121162000165-1319185217.png]: /images/20221022/60d752255342432cafb94da4031824f5.png
[706090-20200121162040362-1816009051.png]: /images/20221022/6382bb51958a441fb27d31839d977fe1.png
[706090-20200121162207404-1203840398.png]: /images/20221022/772d3fd8ae3145218e3f926d63760935.png