详解一款开源免费的.NET文档操作组件DocX（.NET组件介绍之一）

在目前的软件项目中，都会较多的使用到对文档的操作，用于记录和统计相关业务信息。由于系统自身提供了对文档的相关操作，所以在一定程度上极大的简化了软件使用者的工作量。

在.NET项目中如果用户提出了相关文档操作的需求，开发者较多的会使用到微软自行提供的插件，在一定程度上简化了开发人员的工作量，但是同时也给用户带来了一些困扰，例如需要安装庞大的office，在用户体验性就会降低很多，并且在国内，很多人都还是使用wps，这就导致一部分只安装了wps的使用者很是为难，在对Excel的操作方面，有一个NPOI组件。那么可能会有人问有没有什么办法让这些困扰得到解决，答案是肯定的，那就是今天需要介绍的“DocX”组件，接下来我们就来了解一下这个组件的功能和用法。

一.DocX组件概述：

DocX是一个.NET库，允许开发人员以简单直观的方式处理Word 2007/2010/2013文件。 DocX是快速，轻量级，最好的是它不需要安装Microsoft Word或Office。DocX组件不仅可以完成对文档的一般要求，例如创建文档，创建表格和文本，并且还可以创建图形报表。DocX使创建和操作文档成为一个简单的任务。

它不使用COM库，也不需要安装Microsoft Office。在使用DocX组件时，你需要安装为了使用DocX是.NET框架4.0和Visual Studio 2010或更高版本。

DocX的主要特点：

(1).在文档中插入，删除或替换文本。所有标准文本格式都可用。 字体{系列，大小，颜色}，粗体，斜体，下划线，删除线，脚本{子，超级}，突出显示。

(2).段落属性显示。方向LeftToRight或RightToLeft;缩进;比对。  

(3).DocX也支持:图片，超链接，表，页眉和页脚，自定义属性。

有关DocX组件的相关信息就介绍到这里，如果需要更加深入的了解相关信息，可以进入：https://docx.codeplex.com/。

二.DocX相关类和方法解析：

本文将结合DocX的源码进行解析，使用.NET Reflector对DLL文件进行反编译，以此查看源代码。将DLL文件加入.NET Reflector中，点击打开文件。 

 1.DocX.Create()：创建文档。

 public static DocX Create(Stream stream)
{
  MemoryStream stream2 = new MemoryStream();
  PostCreation(ref Package.Open(stream2, FileMode.Create, FileAccess.ReadWrite));
  DocX cx = Load(stream2);
  cx.stream = stream;
  return cx;
}

 2.Paragraph.Append：向段落添加信息。

 public Paragraph Append(string text)
{
  List<XElement> content = HelperFunctions.FormatInput(text, null);
  base.Xml.Add(content);
  this.runs = base.Xml.Elements(XName.Get("r", DocX.w.NamespaceName)).Reverse<XElement>().Take<XElement>(content.Count<XElement>()).ToList<XElement>();
  return this;
}

public Paragraph Bold()
{
  this.ApplyTextFormattingProperty(XName.Get("b", DocX.w.NamespaceName), string.Empty, null);
  return this;
}

3.Table.InsertTableAfterSelf：将数据插入表格。

public override Table InsertTableAfterSelf(int rowCount, int coloumnCount)
{
  return base.InsertTableAfterSelf(rowCount, coloumnCount);
}

public virtual Table InsertTableAfterSelf(int rowCount, int coloumnCount)
{
  XElement content = HelperFunctions.CreateTable(rowCount, coloumnCount);
  base.Xml.AddAfterSelf(content);
  return new Table(base.Document, base.Xml.ElementsAfterSelf().First<XElement>());
}

4.CustomProperty：自定义属性。

public class CustomProperty
{
  // Fields
  private string name;
  private string type;
  private object value;

  // Methods
  public CustomProperty(string name, bool value);
  public CustomProperty(string name, DateTime value);
  public CustomProperty(string name, double value);
  public CustomProperty(string name, int value);
  public CustomProperty(string name, string value);
  private CustomProperty(string name, string type, object value);
  internal CustomProperty(string name, string type, string value);

  // Properties
  public string Name { get; }
  internal string Type { get; }
  public object Value { get; }
}

5.BarChart：创建棒形图。

public class BarChart : Chart
{
  // Methods
  public BarChart();
  protected override XElement CreateChartXml();

  // Properties
  public BarDirection BarDirection { get; set; }
  public BarGrouping BarGrouping { get; set; }
  public int GapWidth { get; set; }
}

public abstract class Chart
{
  // Methods
  public Chart();
  public void AddLegend();
  public void AddLegend(ChartLegendPosition position, bool overlay);
  public void AddSeries(Series series);
  protected abstract XElement CreateChartXml();
  public void RemoveLegend();

  // Properties
  public CategoryAxis CategoryAxis { get; private set; }
  protected XElement ChartRootXml { get; private set; }
  protected XElement ChartXml { get; private set; }
  public DisplayBlanksAs DisplayBlanksAs { get; set; }
  public virtual bool IsAxisExist { get; }
  public ChartLegend Legend { get; private set; }
  public virtual short MaxSeriesCount { get; }
  public List<Series> Series { get; }
  public ValueAxis ValueAxis { get; private set; }
  public bool View3D { get; set; }
  public XDocument Xml { get; private set; }
}

6.Chart的AddLegend(),AddSeries(),RemoveLegend()方法解析：

public void AddLegend(ChartLegendPosition position, bool overlay)
{
  if (this.Legend != null)
  {
    this.RemoveLegend();
  }
  this.Legend = new ChartLegend(position, overlay);
  this.ChartRootXml.Add(this.Legend.Xml);
}

public void AddSeries(Series series)
{
  if (this.ChartXml.Elements(XName.Get("ser", DocX.c.NamespaceName)).Count<XElement>() == this.MaxSeriesCount)
  {
    throw new InvalidOperationException("Maximum series for this chart is" + this.MaxSeriesCount.ToString() + "and have exceeded!");
  }
  this.ChartXml.Add(series.Xml);
}

public void RemoveLegend()
{
  this.Legend.Xml.Remove();
  this.Legend = null;
}

以上是对DocX组件的一些方法的一些简单解析，如果需要知道更多的方法实现代码，可自行进行下载查看。

三.DocX功能实现实例：

1.创建图表：

 /// <summary>
    /// 创建棒形图
    /// </summary>
    /// <param name="path">文档路径</param>
    /// <param name="dicValue">绑定数据</param>
    /// <param name="categoryName">类别名称</param>
    /// <param name="valueName">值名称</param>
    /// <param name="title">图标标题</param>
    public static bool BarChart(string path,Dictionary<string, ICollection> dicValue,string categoryName,string valueName,string title)
    {
      if (string.IsNullOrEmpty(path))
      {
        throw new ArgumentNullException(path);
      }
      if (dicValue == null)
      {
        throw new ArgumentNullException("dicValue");
      }
      if (string.IsNullOrEmpty(categoryName))
      {
        throw new ArgumentNullException(categoryName);
      }
      if (string.IsNullOrEmpty(valueName))
      {
        throw new ArgumentNullException(valueName);
      }
      if (string.IsNullOrEmpty(title))
      {
        throw new ArgumentNullException(title);
      }
      try
      {
        using (var document = DocX.Create(path))
        {
          //BarChart图形属性设置，BarDirection图形方向枚举，BarGrouping图形分组枚举
          var c = new BarChart
          {
            BarDirection = BarDirection.Column,
            BarGrouping = BarGrouping.Standard,
            GapWidth = 400
          };
          //设置图表图例位置
          c.AddLegend(ChartLegendPosition.Bottom, false);
          //写入图标数据
          foreach (var chartData in dicValue)
          {
            var series = new Series(chartData.Key);
            series.Bind(chartData.Value, categoryName, valueName);
            c.AddSeries(series);
          }         
          // 设置文档标题
          document.InsertParagraph(title).FontSize(20);
          document.InsertChart(c);
          document.Save();
          return true;
        }

      }
      catch (Exception ex)
      {
        throw new Exception(ex.Message);
      }
    }

2.创建一个具有超链接、图像和表的文档。

 /// <summary>
    /// 创建一个具有超链接、图像和表的文档。
    /// </summary>
    /// <param name="path">文档保存路径</param>
    /// <param name="imagePath">加载的图片路径</param>
    /// <param name="url">url地址</param>
    public static void HyperlinksImagesTables(string path,string imagePath,string url)
    {
      if (string.IsNullOrEmpty(path))
      {
        throw new ArgumentNullException(path);
      }
      if (string.IsNullOrEmpty(imagePath))
      {
        throw new ArgumentNullException(imagePath);
      }
      if (string.IsNullOrEmpty(url))
      {
        throw new ArgumentNullException(url);
      }
      try
      {
        using (var document = DocX.Create(path))
        {
          var link = document.AddHyperlink("link", new Uri(url));
          var table = document.AddTable(2, 2);
          table.Design = TableDesign.ColorfulGridAccent2;
          table.Alignment = Alignment.center;
          table.Rows[0].Cells[0].Paragraphs[0].Append("1");
          table.Rows[0].Cells[1].Paragraphs[0].Append("2");
          table.Rows[1].Cells[0].Paragraphs[0].Append("3");
          table.Rows[1].Cells[1].Paragraphs[0].Append("4");
          var newRow = table.InsertRow(table.Rows[1]);
          newRow.ReplaceText("4", "5");
          var image = document.AddImage(imagePath);
          var picture = image.CreatePicture();
          picture.Rotation = 10;
          picture.SetPictureShape(BasicShapes.cube);
          var title = document.InsertParagraph().Append("Test").FontSize(20).Font(new FontFamily("Comic Sans MS"));
          title.Alignment = Alignment.center;
          var p1 = document.InsertParagraph();
          p1.AppendLine("This line contains a ").Append("bold").Bold().Append(" word.");
          p1.AppendLine("Here is a cool ").AppendHyperlink(link).Append(".");
          p1.AppendLine();
          p1.AppendLine("Check out this picture ").AppendPicture(picture).Append(" its funky don't you think?");
          p1.AppendLine();
          p1.AppendLine("Can you check this Table of figures for me?");
          p1.AppendLine();
          p1.InsertTableAfterSelf(table);
          var p2 = document.InsertParagraph();
          p2.AppendLine("Is it correct?");
          document.Save();
        }
      }
      catch (Exception ex)
      {
        throw new Exception(ex.Message);
      }
      
    }

 3.将指定内容写入文档：

 /// <summary>
    /// 将指定内容写入文档
    /// </summary>
    /// <param name="path">加载文件路径</param>
    /// <param name="content">写入文件内容</param>
    /// <param name="savePath">保存文件路径</param>
    public static void ProgrammaticallyManipulateImbeddedImage(string path, string content, string savePath)
    {
      if (string.IsNullOrEmpty(path))
      {
        throw new ArgumentNullException(path);
      }
      if (string.IsNullOrEmpty(content))
      {
        throw new ArgumentNullException(content);
      }
      if (string.IsNullOrEmpty(savePath))
      {
        throw new ArgumentNullException(savePath);
      }
      try
      {
        using (var document = DocX.Load(path))
        {
          // 确保此文档至少有一个图像。
          if (document.Images.Any())
          {
            var img = document.Images[0];
            // 将内容写入图片.
            var b = new Bitmap(img.GetStream(FileMode.Open, FileAccess.ReadWrite));
            //获取此位图的图形对象，图形对象提供绘图功能。
            var g = Graphics.FromImage(b);
            // 画字符串内容
            g.DrawString
              (
                content,
                new Font("Tahoma", 20),
                Brushes.Blue,
                new PointF(0, 0)
              );
            // 使用创建\写入流将该位图保存到文档中。
            b.Save(img.GetStream(FileMode.Create, FileAccess.Write), ImageFormat.Png);
          }
          else
          {
            document.SaveAs(savePath);
          } 
        }

      }
      catch (Exception ex)
      {
        throw new Exception(ex.Message);
      }
    }

四.总结：

以上是对DocX组件的API做了一个简单的解析，并且附上一些创建文档和创建图表的方法供开发者参考。希望对大家的学习有所帮助，也希望大家多多支持。

# asp.net  # 操作word文档  # .net  # .NET文档操作  # .NET 开源配置组件 AgileConfig的使用简介  # ASP.NET开源导入导出库Magicodes.IE完成Csv导入导出的方法  # 详解开源免费且稳定实用的.NET PDF打印组件itextSharp（.NET组件介绍之八）  # 详解免费开源的DotNet二维码操作组件ThoughtWorks.QRCode（.NET组件介绍之四  # 详解免费开源的.NET多类型文件解压缩组件SharpZipLib（.NET组件介绍之七）  # 详解最好的.NET开源免费ZIP库DotNetZip（.NET组件介绍之三）  # 详解免费开源的DotNet任务调度组件Quartz.NET（.NET组件介绍之五）  # .NET中开源文档操作组件DocX的介绍与使用  # 基于.NET平台常用的框架和开源程序整理  # .NET 开源项目Polly的简单介绍  # 文档  # 超链接  # 相关信息  # 较多  # 自定义  # 在一  # 开发人员  # 创建一个  # 有一个  # 的是  # 是一个  # 加载  # 就会  # 不需要安装  # 还可以  # 很多人  # 下划线  # 提出了  # 这就  # 微软 

相关文章： 如何通过VPS搭建网站快速盈利？  网站好制作吗知乎,网站开发好学吗？有什么技巧？  在线教育网站制作平台,山西立德教育官网？  制作国外网站的软件,国外有哪些比较优质的网站推荐？  网页设计与网站制作内容,怎样注册网站？  网站专业制作公司有哪些,做一个公司网站要多少钱？  如何高效配置香港服务器实现快速建站？  哪家制作企业网站好,开办像阿里巴巴那样的网络公司和网站要怎么做？  官网网站制作腾讯审核要多久,联想路由器newifi官网  如何通过.red域名打造高辨识度品牌网站？  建站之星后台管理如何实现高效配置？  建站168自助建站系统：快速模板定制与SEO优化指南  如何制作公司的网站链接,公司想做一个网站，一般需要花多少钱？  如何用y主机助手快速搭建网站？  建站上市公司网站建设方案与SEO优化服务定制指南  制作网站软件推荐手机版,如何制作属于自己的手机网站app应用？  如何通过NAT技术实现内网高效建站？  早安海报制作网站推荐大全,企业早安海报怎么每天更换？  平台云上自主建站：模板化设计与智能工具打造高效网站  长沙做网站要多少钱,长沙国安网络怎么样？  岳西云建站教程与模板下载_一站式快速建站系统操作指南  新网站制作渠道有哪些,跪求一个无线渠道比较强的小说网站，我要发表小说？  相亲简历制作网站推荐大全,新相亲大会主持人小萍萍资料？  北京网页设计制作网站有哪些,继续教育自动播放怎么设置？  如何安全更换建站之星模板并保留数据？  广州建站公司哪家好？十大优质服务商推荐  专业企业网站设计制作公司,如何理解商贸企业的统一配送和分销网络建设？  如何用AWS免费套餐快速搭建高效网站？  如何通过可视化优化提升建站效果？  如何在局域网内绑定自建网站域名？  济南网站制作的价格,历城一职专官方网站？  简历在线制作网站免费版,如何创建个人简历？  如何挑选优质建站一级代理提升网站排名？  开封网站制作公司,网络用语开封是什么意思？  实惠建站价格推荐：2025年高性价比自助建站套餐解析  黑客如何通过漏洞一步步攻陷网站服务器？  宿州网站制作公司兴策,安徽省低保查询网站？  标准网站视频模板制作软件,现在有哪个网站的视频编辑素材最齐全的，背景音乐、音效等？  Python多线程使用规范_线程安全解析【教程】  c# F# 的 MailboxProcessor 和 C# 的 Actor 模型  c++怎么实现高并发下的无锁队列_c++ std::atomic原子变量与CAS操作【详解】  高防网站服务器：DDoS防御与BGP线路的AI智能防护方案  大连网站制作费用,大连新青年网站，五年四班里的视频怎样下载啊？  品牌网站制作公司有哪些,买正品品牌一般去哪个网站买？  历史网站制作软件,华为如何找回被删除的网站？  弹幕视频网站制作教程下载,弹幕视频网站是什么意思？  如何挑选最适合建站的高性能VPS主机？  阿里云网站制作公司,阿里云快速搭建网站好用吗？  常州自助建站工具推荐：低成本搭建与模板选择技巧  建站之星多图banner生成与模板自定义指南