.NET中開源文檔操作組件DocX怎么用

這篇文章主要介紹.NET中開源文檔操作組件DocX怎么用，文中介紹的非常詳細(xì)，具有一定的參考價(jià)值，感興趣的小伙伴們一定要看完！

一.DocX組件概述：

DocX是一個(gè).NET庫，允許開發(fā)人員以簡單直觀的方式處理Word 2007/2010/2013文件。 DocX是快速，輕量級(jí)，最好的是它不需要安裝Microsoft Word或Office。DocX組件不僅可以完成對(duì)文檔的一般要求，例如創(chuàng)建文檔，創(chuàng)建表格和文本，并且還可以創(chuàng)建圖形報(bào)表。DocX使創(chuàng)建和操作文檔成為一個(gè)簡單的任務(wù)。

它不使用COM庫，也不需要安裝Microsoft Office。在使用DocX組件時(shí)，你需要安裝為了使用DocX是.NET框架4.0和Visual Studio 2010或更高版本。

   DocX的主要特點(diǎn)：

     (1).在文檔中插入，刪除或替換文本。所有標(biāo)準(zhǔn)文本格式都可用。 字體{系列，大小，顏色}，粗體，斜體，下劃線，刪除線，腳本{子，超級(jí)}，突出顯示。

     (2).段落屬性顯示。方向LeftToRight或RightToLeft;縮進(jìn);比對(duì)。  

     (3).DocX也支持:圖片，超鏈接，表，頁眉和頁腳，自定義屬性。

  有關(guān)DocX組件的相關(guān)信息就介紹到這里，如果需要更加深入的了解相關(guān)信息，可以進(jìn)入：https://docx.codeplex.com/。

二.DocX相關(guān)類和方法解析：

本文將結(jié)合DocX的源碼進(jìn)行解析，使用.NET Reflector對(duì)DLL文件進(jìn)行反編譯，以此查看源代碼。將DLL文件加入.NET Reflector中，點(diǎn)擊打開文件。 

1.DocX.Create() ：創(chuàng)建文檔。

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：將數(shù)據(jù)插入表格。

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：創(chuàng)建棒形圖。

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;
}

以上是對(duì)DocX組件的一些方法的一些簡單解析，如果需要知道更多的方法實(shí)現(xiàn)代碼，可自行進(jìn)行下載查看。

三.DocX功能實(shí)現(xiàn)實(shí)例：

1.創(chuàng)建圖表：

  /// <summary>
  /// 創(chuàng)建棒形圖
  /// </summary>
  /// <param name="path">文檔路徑</param>
  /// <param name="dicValue">綁定數(shù)據(jù)</param>
  /// <param name="categoryName">類別名稱</param>
  /// <param name="valueName">值名稱</param>
  /// <param name="title">圖標(biāo)標(biāo)題</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圖形屬性設(shè)置，BarDirection圖形方向枚舉，BarGrouping圖形分組枚舉
     var c = new BarChart
     {
      BarDirection = BarDirection.Column,
      BarGrouping = BarGrouping.Standard,
      GapWidth = 400
     };
     //設(shè)置圖表圖例位置
     c.AddLegend(ChartLegendPosition.Bottom, false);
     //寫入圖標(biāo)數(shù)據(jù)
     foreach (var chartData in dicValue)
     {
      var series = new Series(chartData.Key);
      series.Bind(chartData.Value, categoryName, valueName);
      c.AddSeries(series);
     }     
     // 設(shè)置文檔標(biāo)題
     document.InsertParagraph(title).FontSize(20);
     document.InsertChart(c);
     document.Save();
     return true;
    }

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

2.創(chuàng)建一個(gè)具有超鏈接、圖像和表的文檔。

  /// <summary>
  /// 創(chuàng)建一個(gè)具有超鏈接、圖像和表的文檔。
  /// </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.將指定內(nèi)容寫入文檔：

  /// <summary>
  /// 將指定內(nèi)容寫入文檔
  /// </summary>
  /// <param name="path">加載文件路徑</param>
  /// <param name="content">寫入文件內(nèi)容</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))
    {
     // 確保此文檔至少有一個(gè)圖像。
     if (document.Images.Any())
     {
      var img = document.Images[0];
      // 將內(nèi)容寫入圖片.
      var b = new Bitmap(img.GetStream(FileMode.Open, FileAccess.ReadWrite));
      //獲取此位圖的圖形對(duì)象，圖形對(duì)象提供繪圖功能。
      var g = Graphics.FromImage(b);
      // 畫字符串內(nèi)容
      g.DrawString
       (
        content,
        new Font("Tahoma", 20),
        Brushes.Blue,
        new PointF(0, 0)
       );
      // 使用創(chuàng)建\寫入流將該位圖保存到文檔中。
      b.Save(img.GetStream(FileMode.Create, FileAccess.Write), ImageFormat.Png);
     }
     else
     {
      document.SaveAs(savePath);
     } 
    }

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

以上是“.NET中開源文檔操作組件DocX怎么用”這篇文章的所有內(nèi)容，感謝各位的閱讀！希望分享的內(nèi)容對(duì)大家有幫助，更多相關(guān)知識(shí)，歡迎關(guān)注億速云行業(yè)資訊頻道！