C#结合html2canvas生成切割图片并导出到PDF

目录

需求

开发运行环境

实现

生成HTML范例片断

HTML元素转BASE64

BASE64转图片

切割长图片

生成PDF文件

小结

需求

html2canvas 是一个 JavaScript 库，它可以把任意一个网页中的元素（包括整个网页）绘制到指定的 canvas 中，适用于生成网截图或将指定元素容器内容保存为图像等。现有需求如下：

1、C#后台输出HTML片段内容到客户端；

2、引入 html2canvas 库，放置 canvas 对象，操作客户端功能保存 canvas 内容生成图像 base64数据；

3、回传 base64 数据，C# 生成图像

4、C# 对于生成的长图进行切割，生成多张图片

5、将多张图片导出生成到PDF文件。

开发运行环境

操作系统： Windows Server 2019 DataCenter

.net版本： .netFramework4.7.2 

js库：html2canvas  1.3.2  版本库

数据库：MS SQL SERVER 2016

开发工具：VS2019  C#

实现

生成HTML范例片断

我们假设有存储过程（CCDN_getTableDetail），通过传递表名参数（@tablename nvarchar(50)），可以获取表的详细信息，包括（表名、表说明、字段序号、字段名、字段说明、标识、主键、类型、长度、占用字节数、小数位数、允许空、默认值），代码如下：

CREATE PROCEDURE CCDN_getTableDetail 
  @tablename nvarchar(50)
AS
BEGIN
	-- SET NOCOUNT ON added to prevent extra result sets from
	-- interfering with SELECT statements.
	SET NOCOUNT ON;
SELECT
	表名=convert(nvarchar(50),case when a.colorder=1 then d.name else '' end),
	表说明=convert(nvarchar(50),case when a.colorder=1 then isnull(f.value,'') else '' end),
	字段序号=convert(nvarchar(50),a.colorder),
	字段名=convert(nvarchar(50),a.name),
	字段说明=convert(nvarchar(50),isnull(g.[value],'')),
	标识=convert(nvarchar(50),case when COLUMNPROPERTY(a.id,a.name,'IsIdentity')=1 then '√'else '' end),
	主键=convert(nvarchar(50),case when exists(SELECT 1 FROM sysobjects where xtype='PK' and name in (
	  SELECT name FROM sysindexes WHERE indid in(
	   SELECT indid FROM sysindexkeys WHERE id = a.id AND colid=a.colid
	   ))) then '√' else '' end),
	类型=convert(nvarchar(50),b.name),
	长度=convert(nvarchar(50),COLUMNPROPERTY(a.id,a.name,'PRECISION')),
	占用字节数=convert(nvarchar(50),a.length),
	小数位数=convert(nvarchar(50),isnull(COLUMNPROPERTY(a.id,a.name,'Scale'),0)),
	允许空=convert(nvarchar(50),case when a.isnullable=1 then 'NULL'else 'NOT NULL' end),
	默认值=convert(nvarchar(50),isnull(e.text,''))
	FROM syscolumns a
	left join systypes b on a.xtype=b.xusertype
	inner join sysobjects d on a.id=d.id and d.xtype='U' and d.name<>'dtproperties'
	left join syscomments e on a.cdefault=e.id
	left join sys.extended_properties g on a.id=g.major_id and a.colid=g.minor_id
	left join sys.extended_properties f on d.id=f.major_id and f.minor_id =0
	where d.name=@tablename
	order by a.id,a.colorder
END

运行效果如下图：

现我们通过 DataSet 获取数据集数据，并绑定显示在 DataGrid 控件（q_dbgrid）上。 如何获取数据集信息可阅读我的文章《C# 利用IDbDataAdapter / IDataReader 实现通用数据集获取》。

绑定示例代码如下：

        object rv2 = GetDataSet(sql, paras,CommandType.StoredProcedure);
        DataSet ds = (DataSet)rv2;
        DataTable dt = ds.Tables[0];
        q_dbgrid.AllowPaging = true;
        q_dbgrid.PagerStyle.Visible = false;
        q_dbgrid.PageSize = 1000;

        q_dbgrid.DataSource = ds;
        q_dbgrid.DataBind();

HTML元素转BASE64

在页面上放置 canvas 画布控件（myCanvas）和临时存放BASE64数据的 TextBox 控件（ds），首先需要引用 html2canvas js库，如下：

<script src="https://cdnjs.cloudflare.com/ajax/libs/html2canvas/1.3.2/html2canvas.min.js"></script>

客户端示例代码如下：

<script language="javascript" type="text/javascript">

window.onload = function () {
    var canvas = document.getElementById("myCanvas")


    html2canvas(document.getElementById("q_dbgrid")).then(canvas => {
    document.getElementById("myCanvas").appendChild(canvas); // 将生成的canvas添加到页面上
    var image = canvas.toDataURL("image/jpeg");
    document.getElementById("ds").value = image;

  });

}
</script>

 通过 html2canvas 方法生成 jpeg类型的图像数据（canvas.toDataURL("image/jpeg")）并存储在 ds 控件里。

BASE64转图片

Base64StringToImage方法说明如下表：

实现代码如下：

public bool Base64StringToImage(string strbase64, string outputFilename)
{
 
       byte[] arr = Convert.FromBase64String(strbase64);
       MemoryStream ms = new MemoryStream(arr);
       System.Drawing.Image img = System.Drawing.Image.FromStream(ms);
       img.Save(outputFilename);
       img.Dispose();
       if (File.Exists(outputFilename))
       {
           return true;
       }
 
       return false;
}

切割长图片

为保证较好的显示效果，可能需要对长图片进行切割，生成多个图像文件，并存到指定的目录里，以备后续导出生成PDF文件使用。示例代码如下：

string outjpgpath = "D:\\testPDF\\";
string filename="D:\\test.jpg";
string base64Data = ds.Text.Trim().Replace("data:image/jpeg;base64,", "");
Base64StringToImage(base64Data, filename);

System.Drawing.Bitmap sbitmap = new System.Drawing.Bitmap(filename);
int out_width = sbitmap.Width;
int ref_height = 1000; int com_height = sbitmap.Height;
int hCount =sbitmap.Height<ref_height?1:sbitmap.Height % ref_height==0?sbitmap.Height/ref_height:sbitmap.Height/ref_height+1;
int out_top = 0;
int out_height = ref_height;
        
for (int i = 1; i <= hCount; i++)
{
     if (i == 1) { out_top = 0; } else { out_top = ref_height * (i - 1) + 1; }
     out_height = com_height < ref_height ? System.Math.Abs(com_height)-1 : ref_height;
     com_height -= ref_height;
     System.Drawing.Bitmap dbitmap = sbitmap.Clone(new System.Drawing.RectangleF(0, out_top, sbitmap.Width, out_height), System.Drawing.Imaging.PixelFormat.Format24bppRgb);
     string f = "test" + ("0000" + i.ToString()).PadLeft(4) + ".jpg";
     dbitmap.Save(outjpgpath + f);
     dbitmap.Dispose();
}
sbitmap.Dispose();

outjpgpath为输出的多图片目录，filename 为生成的长图的地址。

ref_height为自定义的切割高度，根据指定切割高底生成若干“子”图片。

生成PDF文件

通过读取目录中的多个图像文件生成PDF，可阅读我的文章《C# 将批量图片转为PDF文件》，这里不再赘述。

小结

切割图片中的 ref_height，我们可以根据自定义的要求进行设定，如某些标准的页面尺寸像素值。另外，一些异常情况也需要进行判断，图片的生成质量也可以进行调整 ，这些我们都要根据实际的应用进行调整。

另外，还可以通过API的方式，将网页内容保存为图片，循环生成对应的图片，以解决长图片切割的问题，可参阅我的文章《C# 实现网页内容保存为图片并生成压缩包》

感谢您的阅读，希望本文能够对您有所帮助。