CLR_CreateImageByHtml 根据HTML内容生成图片接口 - .Net 平台标准存储过程&函数&CLR方法

# 1 概述
调用本CLR接口函数，可以根据任意HTML内容生成一张图片，图片可以完美显示该HTML内容的显示效果，并且还可以对图片进行裁剪，显示我们想要显示的部分图片内容。

# 2 安装 CLR

![](/media//202212/2022-12-07_145748.png)

# 3 CLR_CreateImageByHtml 接口 参数说明

```sql
	@Html nvarchar(max),			--	需要生成图片的HTML内容
	@Directory nvarchar(500) = null	 /*	
									生成图片存放的指定目录路径值如"F:\Image\Html"。
									若传递空值则使用默认路径"D:\HtmlImages"。
									*/
```
CLR_CreateImageByHtml 是一个标量函数，其返回值是生成的图片在数据库服务器电脑里面的磁盘路径。

# 4 调用示例 
下面举例说明 CLR_CreateImageByHtml 函数的用法
# 4.1 普通调用示例
调用代码：
```sql
select dbo.CLR_CreateImageByHtml('
		<table border="1" cellspacing="0" align="center" width="750">
			<tr>
				<td width="150" height="40" bgcolor="aqua" align="center">员工姓名</th>
				<td width="150" height="40"></th>
				<td width="150" height="40" bgcolor="aqua" align="center">性别</th>
				<td width="150" height="40"></th>
				<td width="150" height="40" rowspan="4" align="center" >照片</th>
			</tr> 
			<tr>
				<td width="150" height="40" bgcolor="aqua" align="center">入职日期</td>
				<td width="150" height="40"></td>
				<td width="150" height="40" bgcolor="aqua" align="center">籍贯</td> 
				<td width="150" height="40"></td>
				
			</tr>
			<tr>
				<td width="150" height="40" bgcolor="aqua" align="center">入职岗位</td>
				<td width="150" height="40"></td>
				<td width="150" height="40" bgcolor="aqua" align="center">民族</td> 
				<td width="150" height="40"></td>
			</tr>
			<tr>
				<td width="150" height="40" bgcolor="aqua" align="center">联系电话</td>
				<td width="150" height="40"></td>
				<td width="150" height="40" bgcolor="aqua" align="center">电子邮箱</td> 
				<td width="150" height="40"></td>
			</tr>
			<tr>
				<td width="150" height="100" bgcolor="aqua" align="center">工作经历</td>
				<td width="600" height="100" colspan="4"></td>
			</tr>
			<tr >
				<td width="150" height="100" bgcolor="aqua" align="center">教育经历</td>
				<td width="600" height="100" colspan="4"></td>
			</tr>
		</table>')
```
调用结果：

![](/media//202212/2022-12-07_150445.png)

返回的就是生成的图片在服务器上的完整磁盘路径，图片显示效果如下图：

![](/media//202212/2022-12-07_152446.png)

# 4.2 图片裁剪
从上面的例子可以看到生成的图片默认会有一些边距空白，我们可以在HTML里面加入一些代码来灵活来实对图片的裁剪，裁剪图片有以下两种方式：

**(1) 指定左上右下四边裁剪长度的方式**
可以在HTML代码里面的任意位置加上代码标识 “{cut|正整数,正整数,正整数,正整数}” 来实现裁剪，其中3个逗号分隔的4个正整数分别代表需要从 左、上、右、下 裁剪的长度，下面举例说明，代码如下：

![](/media//202212/2022-12-07_152853.png)

代码中在HTML里面加上了 “{cut|8,8,0,0}” 表示 左边裁剪8个像素，上面裁剪8个像素，右边和下边没有裁剪，生成的图片效果如下：

![](/media//202212/2022-12-07_152934.png)

从图片中发现左边和上面裁剪了8个像素，而右边和下边没有裁剪还有边距，这样我们就可以对图片的4边进行灵活裁剪调整。

**(2) 指定一个HTML元素进行裁剪的方式**
裁剪的另一种方式就是，可以在HTML中的某一个元素加上 值为 “cut” 的 “id” 属性，来单单把该元素裁剪出来成为一张图片，比如在上例中我们要刚好把整个表格裁剪出来，则只需要在表格元素加上 id=”cut”,代码如下：

![](/media//202212/2022-12-07_153113.png)

这样生成的图片就只会刚好显示表格，如下图：

![](/media//202212/2022-12-07_153147.png)

再举个例子，比如我们要把 工作经历 哪一行裁剪出来生成图片，则只需要在 工作经历 所在的行元素中加上 id=”cut”,代码如下：

![](/media//202212/2022-12-07_153336.png)

这样生成的图片，只会显示工作经历的行，如下图：

![](/media//202212/2022-12-07_153405.png)

至此已经说明了可以有两种方式对HTML生成的图片进行裁剪，为的就是可以灵活的调整图片的可见范围。

**注：**
以上两种裁剪方式只能使用一种，不能同时使用，如果两种都进行了设置则只会运用第二种。