SQL Server 2005 - 如何从CLR存储过程传回表格结果与讯息.docxVIP

亲爱的朋友们，阅读过《实作 CLR 存储过程》一文之后，相信大家对于如何建立 CLR 存储过程已经有了清楚的认识。在本文中，我们要继续讨论一个非常重要的课题，那就是如何从CLR 存储过程传回表格结果与讯息。 除了通过输出参数传回数据之外，我们还可以使用 SqlPipe 对象将表格结果与讯息传回给客户端。一般来说，我们是通过 SqlContext 类别的Pipe 属性取得 SqlPipe 对象，然后呼叫 SqlPipe 对象的 Send 方法将表格结果或讯息传送给客户端。 SqlPipe 对象的 Send 方法拥有下列三个多载版本： ?????????? SqlPipe.Send(message As String) 此多载版本的 Send 方法能够将字符串讯息直接传送至客户端。文字讯息最长不可超过 8000 个字符，超出 8000 个字符的部分将会被截掉。 讯息字符串会被当作一个信息讯息传送给客户端，至于客户端要通过哪一种机制来聆听此讯息，则视客户端所采用的数据存取应用程序接口（API）而定。比方说，假设客户端使用ADO.NET，则讯息会通过事件 InfoMessage 来传送。 ?????????? SqlPipe.Send(record As SqlDataRecord) 此多载版本的 Send 方法能够将单一数据列结果集（也就是一个 SqlDataRecord 对象）直 接传送至客户端。如果您于 Send 方法中所使用的 SqlDataReader 对象拥有隐藏字段，这些字段将不会填入传送给客户端的结果集当中。 以前一篇文章所建立的 CLR 存储过程 SayHello 而言，它除了使用输出参数来传回文字数据之外，还呼叫此多载版本的 Send 方法将单一数据列结果集直接传送至客户端，如下所示： SqlContext.Pipe.Send(greetingRecord) SqlPipe.Send(reader As SqlDataReader) 此多载版本的 Send 方法能够将一个多数据列结果集（也就是一个 SqlDataReader 对象） 直接传送至客户端。 如果您要传送先前通过同处理序（In-Process）提供者所执行的查询结果，或是想要使用SqlDataReader 的自订实作来预先处理数据，请使此多载版本的 Send 方法来接收一个SqlDataReader 对象并将其直接传送给客户端。虽然 Send 方法的执行效率稍稍慢于ExecuteAndSend 方法，不过在数据被传送至客户端之前，它提供了最大的弹性来处理数据。 请大家注意，除了使用 Send 方法之外，CLR 存储过程还可以使用 SqlPipe 对象的 ExecuteAndSend 方法将查询结果传送给客户端。ExecuteAndSend 方法的最大好处，就是 它提供了一种最高效率的方式将查询结果传送给客户端， 之所以如此，是因为数据是通过网络缓冲区来传送，而不需被复制到受管理的内存中。 以下是 ExecuteAndSend 方法的语法： SqlPipi.ExecuteAndSend (command As SqlCommand) 从语法可以看出，ExecuteAndSend 方法其实是以一个 SqlCommand 对象作为其参数，它会执行 SqlCommand 对象并将结果传送至客户端。大家必须了解，除了所有实际的执行结果之外，其它的讯息与错误也会直接传送给客户端。 程序范例 以下我们示范如何使用 SqlPipe 对象的 Send 方法将文字符串直接传送至客户端： 下面这一个 CLR 存储过程存放于类别库项目 GiveYouString 中，它示范如何使用 SqlPipe 对象的 Send 方法将文字符串直接传送至客户端： namespace GiveYouString { public class GiveYouStringClass { [Microsoft.SqlServer.Server.SqlProcedure()] public static void GiveYouString () { // 呼叫 Pipe 对象的 Send 方法将文字符串直接传送给客户端。 SqlContext.Pipe.Send(章立民研究室); } } } 请注意，这一个 CLR 存储过程并没有任何参数。 请执行如下所示之 SQL 指令码，登录组件 GiveYouString.dll、建立一个参考所登录之组件 GiveYouString.dll 的存储过程、然后执行此 CLR 存储过程： USE 北风贸易; GO IF EXISTS (SELECT * FROM cedures WHERE [name] = GiveYouString) DROP PROCEDUR