Execute、Requery 和 Clear 方法范例

该范例演示运行来自 Command 对象和 Connection 对象的 Execute 方法。同时使用 Requery 方法检索记录集中的当前数据,并用 Clear 方法清除 Errors 集合的内容。运行该过程需要 ExecuteCommand 和 PrintOutput 过程。

Public Sub ExecuteX()

   Dim strSQLChange As String

   Dim strSQLRestore As String

   Dim strCnn As String

   Dim cnn1 As ADODB.Connection

   Dim cmdChange As ADODB.Command

   Dim rstTitles As ADODB.Recordset

   Dim errLoop As ADODB.Error

   ' 定义两个 SQL 语句作为命令文本执行。

   strSQLChange = "UPDATE Titles SET Type = " & _

      "'self_help' WHERE Type = 'psychology'"

   strSQLRestore = "UPDATE Titles SET Type = " & _

      "'psychology' WHERE Type = 'self_help'"

   ' 打开连接。

      strCnn = "Provider=sqloledb;" & _

      "Data Source=srv;Initial Catalog=pubs;User Id=sa;Password=; "

   Set cnn1 = New ADODB.Connection

   cnn1.Open strCnn

   ' 创建命令对象。

   Set cmdChange = New ADODB.Command

   Set cmdChange.ActiveConnection = cnn1

   cmdChange.CommandText = strSQLChange

   ' 打开标题表。

   Set rstTitles = New ADODB.Recordset

   rstTitles.Open "titles", cnn1, , , adCmdTable

   ' 打印原始数据报告。

   Debug.Print _

      "Data in Titles table before executing the query"

   PrintOutput rstTitles

   ' 清除 Errors 集合的外部错误。

   cnn1.Errors.Clear

   ' 调用 ExecuteCommand 子例程执行 cmdChange 命令。

   ExecuteCommand cmdChange, rstTitles

   ' 打印新数据报告。

   Debug.Print _

      "Data in Titles table after executing the query"

   PrintOutput rstTitles

   ' 使用 Connection 对象的 execute 方法执行 SQL 语句以恢复数据。

   ' 捕获错误,必要时检查 Errors 集合。

   On Error GoTo Err_Execute

   cnn1.Execute strSQLRestore, , adExecuteNoRecords

   On Error GoTo 0

   ' 通过再查询记录集检索当前数据。

   rstTitles.Requery

   ' 打印已恢复数据的报告。

   Debug.Print "Data after executing the query " & _

      "to restore the original information"

   PrintOutput rstTitles

   rstTitles.Close

   cnn1.Close

   Exit Sub

Err_Execute:

   ' 将任何由执行查询引起的错误通知用户。

   If Errors.Count > 0 Then

      For Each errLoop In Errors

         MsgBox "Error number: " & errLoop.Number & vbCr & _

            errLoop.Description

      Next errLoop

   End If

   Resume Next

End Sub

Public Sub ExecuteCommand(cmdTemp As ADODB.Command, _

   rstTemp As ADODB.Recordset)

   Dim errLoop As Error

   ' 运行指定的 Command 对象。捕获错误,必要时检查 Errors 集合。

   On Error GoTo Err_Execute

   cmdTemp.Execute

   On Error GoTo 0

   ' 通过再查询记录集检索当前数据。

   rstTemp.Requery

   Exit Sub

Err_Execute:

   ' 将任何由执行查询引起的错误通知用户。

   If Errors.Count > 0 Then

      For Each errLoop In Errors

         MsgBox "Error number: " & errLoop.Number & vbCr & _

            errLoop.Description

      Next errLoop

   End If

   Resume Next

End Sub

Public Sub PrintOutput(rstTemp As ADODB.Recordset)

   ' 枚举 Recordset。

   Do While Not rstTemp.EOF

      Debug.Print "  " & rstTemp!Title & _

         ", " & rstTemp!Type

      rstTemp.MoveNext

   Loop

End Sub

VBScript 版本

下面是使用 VBScript 编写、并用于 Active Server Page (ASP) 的相同范例。如需查看该完整功能范例,请使用与 IIS 一同安装并位于 C:\InetPub\ASPSamp\AdvWorks 的数据源 AdvWorks.mdb,来创建名为 AdvWorks 的系统“数据源名称”(DSN)。这是 Microsoft Access 数据库文件。请使用查找命令定位文件 Adovbs.inc,并将其放入计划使用的目录中。请将以下代码剪切并粘贴到记事本或其他文本编辑器中,另存为“Execute.asp”。这样,便可在任何客户端浏览器中查看结果。

<!-- #Include file="ADOVBS.INC" -->

<HTML><HEAD>

<TITLE>ADO Execute Method</TITLE></HEAD>

<BODY>

<FONT FACE="MS SANS SERIF" SIZE=2>

<Center><H3>ADO Execute Method</H3><H4>Recordset Retrieved Using Connection Object</H4>

<TABLE WIDTH=600 BORDER=0>

<TD VALIGN=TOP ALIGN=LEFT COLSPAN=3><FONT SIZE=2>

<!--- Recordsets 使用 Connection 和 Command 对象的 Execute 方法进行检索 -->

<%

Set OBJdbConnection = Server.CreateObject("ADODB.Connection")

OBJdbConnection.Open "AdvWorks"

SQLQuery = "SELECT * FROM Customers"

' 第一个 Recordset RSCustomerList

Set RSCustomerList = OBJdbConnection.Execute(SQLQuery)

Set OBJdbCommand = Server.CreateObject("ADODB.Command")

OBJdbCommand.ActiveConnection = OBJdbConnection

SQLQuery2 = "SELECT * From Products"

OBJdbCommand.CommandText = SQLQuery2

Set RsProductList = OBJdbCommand.Execute

%>

<TABLE COLSPAN=8 CELLPADDING=5 BORDER=0>

<!-- Customer 表的 BEGIN 列标头行 -->

<TR><TD ALIGN=CENTER BGCOLOR="#008080">

<FONT STYLE="ARIAL NARROW" COLOR="#ffffff" SIZE=1>Company Name</FONT>

</TD>

<TD ALIGN=CENTER BGCOLOR="#008080">

<FONT STYLE="ARIAL NARROW" COLOR="#ffffff" SIZE=1>Contact Name</FONT>

</TD>

<TD ALIGN=CENTER WIDTH=150 BGCOLOR="#008080">

<FONT STYLE="ARIAL NARROW" COLOR="#ffffff" SIZE=1>E-mail address</FONT>

</TD>

<TD ALIGN=CENTER BGCOLOR="#008080">

<FONT STYLE="ARIAL NARROW" COLOR="#ffffff" SIZE=1>City</FONT>

</TD>

<TD ALIGN=CENTER BGCOLOR="#008080">

<FONT STYLE="ARIAL NARROW" COLOR="#ffffff" SIZE=1>State/Province</FONT>

</TD></TR>

<!-- 显示 Customer 表的 ADO 数据 -->

<% Do While Not RScustomerList.EOF %>

  <TR>

  <TD BGCOLOR="f7efde" ALIGN=CENTER>

  <FONT STYLE="ARIAL NARROW" SIZE=1>

  <%= RSCustomerList("CompanyName")%>

  </FONT></TD>

  <TD BGCOLOR="f7efde" ALIGN=CENTER>

  <FONT STYLE="ARIAL NARROW" SIZE=1>

  <%= RScustomerList("ContactLastName") & ", " %>

  <%= RScustomerList("ContactFirstName") %>

  </FONT></TD>

  <TD BGCOLOR="f7efde" ALIGN=CENTER>

  <FONT STYLE="ARIAL NARROW" SIZE=1>

  

  <%= RScustomerList("ContactLastName")%>

 </FONT></TD>

  <TD BGCOLOR="f7efde" ALIGN=CENTER>

  <FONT STYLE="ARIAL NARROW" SIZE=1>

  <%= RScustomerList("City")%>

  </FONT></TD>

  <TD BGCOLOR="f7efde" ALIGN=CENTER>

  <FONT STYLE="ARIAL NARROW" SIZE=1>

  <%= RScustomerList("StateOrProvince")%>

  </FONT></TD>

  </TR>

<!-Next Row = Record Loop 并添加到 html 表 -->

<%

RScustomerList.MoveNext

Loop

RScustomerList.Close

%>

</TABLE><HR>

<H4>Recordset Retrieved Using Command Object</H4>

<TABLE COLSPAN=8 CELLPADDING=5 BORDER=0>

<!-- Product List 表的 BEGIN 列标头行 -->

<TR><TD ALIGN=CENTER BGCOLOR="#800000">

<FONT STYLE="ARIAL NARROW" COLOR="#ffffff" SIZE=1>Product Type</FONT>

</TD>

<TD ALIGN=CENTER BGCOLOR="#800000">

<FONT STYLE="ARIAL NARROW" COLOR="#ffffff" SIZE=1>Product Name</FONT>

</TD>

<TD ALIGN=CENTER WIDTH=350 BGCOLOR="#800000">

<FONT STYLE="ARIAL NARROW" COLOR="#ffffff" SIZE=1>Product Description</FONT>

</TD>

<TD ALIGN=CENTER BGCOLOR="#800000">

<FONT STYLE="ARIAL NARROW" COLOR="#ffffff" SIZE=1>Unit Price</FONT>

</TD></TR>

<!-- 显示 ADO 数据的 Product List -->

<% Do While Not RsProductList.EOF %>

  <TR>

  <TD BGCOLOR="f7efde" ALIGN=CENTER>

  <FONT STYLE="ARIAL NARROW" SIZE=1>

  <%= RsProductList("ProductType")%>

  </FONT></TD>

  <TD BGCOLOR="f7efde" ALIGN=CENTER>

  <FONT STYLE="ARIAL NARROW" SIZE=1>

  <%= RsProductList("ProductName")%>

  </FONT></TD>

  <TD BGCOLOR="f7efde" ALIGN=CENTER>

  <FONT STYLE="ARIAL NARROW" SIZE=1>

   <%= RsProductList("ProductDescription")%>

 </FONT></TD>

  <TD BGCOLOR="f7efde" ALIGN=CENTER>

  <FONT STYLE="ARIAL NARROW" SIZE=1>

  <%= RsProductList("UnitPrice")%>

  </FONT></TD>

<!--  Next Row = Record -->

<%

RsProductList.MoveNext

Loop

' 从内存删除对象以释放资源。

RsProductList.Close

OBJdbConnection.Close

Set ObJdbCommand = Nothing

Set RsProductList = Nothing

Set OBJdbConnection = Nothing

%>

</TABLE></FONT></Center></BODY></HTML>