在目前的软件项目中，都会较多的使用到对文档的操做，用于记录和统计相关业务信息。因为系统自身提供了对文档的相关操做，因此在必定程度上极大的简化了软件使用者的工做量。html
在.NET项目中若是用户提出了相关文档操做的需求，开发者较多的会使用到微软自行提供的插件，在必定程度上简化了开发人员的工做量，可是同时也给用户带来了一些困扰，例如须要安装庞大的office，在用户体验性就会下降不少，而且在国内，不少人都仍是使用wps，这就致使一部分只安装了wps的使用者非常为难，在对Excel的操做方面，有一个NPOI组件。那么可能会有人问有没有什么办法让这些困扰获得解决，答案是确定的，那就是今天须要介绍的“DocX”组件，接下来咱们就来了解一下这个组件的功能和用法。框架
DocX是一个.NET库，容许开发人员以简单直观的方式处理Word 2007/2010/2013文件。 DocX是快速，轻量级，最好的是它不须要安装Microsoft Word或Office。DocX组件不只能够完成对文档的通常要求，例如建立文档，建立表格和文本，而且还能够建立图形报表。DocX使建立和操做文档成为一个简单的任务。ide
它不使用COM库，也不须要安装Microsoft Office。在使用DocX组件时，你须要安装为了使用DocX是.NET框架4.0和Visual Studio 2010或更高版本。post
DocX的主要特色： 字体
(1).在文档中插入，删除或替换文本。全部标准文本格式均可用。 字体{系列，大小，颜色}，粗体，斜体，下划线，删除线，脚本{子，超级}，突出显示。this
(2).段落属性显示。方向LeftToRight或RightToLeft;缩进;比对。 url
(3).DocX也支持:图片，超连接，表，页眉和页脚，自定义属性。spa
有关DocX组件的相关信息就介绍到这里，若是须要更加深刻的了解相关信息，能够进入：https://docx.codeplex.com/。插件
本文将结合DocX的源码进行解析，使用.NET Reflector对DLL文件进行反编译，以此查看源代码。将DLL文件加入.NET Reflector中，点击打开文件。 code
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; }
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; }
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>()); }
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; } }
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; } }
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组件的一些方法的一些简单解析，若是须要知道更多的方法实现代码，可自行进行下载查看。
/// <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); } }
/// <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); } }
/// <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作了一个简单的解析，而且附上一些建立文档和建立图表的方法供开发者参考。
一款开源免费的.NET文档操做组件DocX（.NET组件介绍之一）http://www.cnblogs.com/pengze0902/p/6122311.html
高效而稳定的企业级.NET Office 组件Spire（.NET组件介绍之二）http://www.cnblogs.com/pengze0902/p/6125570.html
最好的.NET开源免费ZIP库DotNetZip（.NET组件介绍之三）http://www.cnblogs.com/pengze0902/p/6124659.html
免费开源的DotNet二维码操做组件ThoughtWorks.QRCode（.NET组件介绍之四）http://www.cnblogs.com/pengze0902/p/6134506.html
免费开源的DotNet任务调度组件Quartz.NET（.NET组件介绍之五）http://www.cnblogs.com/pengze0902/p/6128558.html
免费高效实用的Excel操做组件NPOI（.NET组件介绍之六）http://www.cnblogs.com/pengze0902/p/6150070.html