📄 odbc-c4.htm
字号:
<html>
<head>
<title>ODBC Programming Tutorial: 检索结果</title>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
</head>
<body bgcolor="#000000" text="#FFFFFF" link="#FFFFCC" vlink="#ffFFCC" alink="#CCFFCC">
<h1 align="center"><font face="Tahoma" color="#FFFFCC">获得结果</font></h1>
<p><font face="Tahoma" size="-1">在本章中,我们来学习如何获得SQL语句的执行结果。</font></p>
<p><font face="Tahoma" size="-1">我们称由查询返回的一组记录为一个<font color="#CCFFCC"><b>
结果集(result set)</b></font> (或在VB中被称为recordset).检索结果通常分为以下几个步骤:</font></p>
<ol>
<li><font face="Tahoma" size="-1">确认一个结果集是否可用。</font></li>
<li><font face="Tahoma" size="-1">将结果集的列绑定在适当的变量上。</font></li>
<li><font face="Tahoma" size="-1">取得行</font></li>
</ol>
<p><font face="Tahoma" size="-1">完成对结果集的操作后,我们必须调用<font color="#FFFFCC"><b>SQLCloseCursor</b></font>来销毁它.</font></p>
<h4><font face="Tahoma" color="#FFFFCC">确认一个结果集是否可用</font></h4>
<p><font face="Tahoma" size="-1">有时在执行SQL语句后,我们就已经知道结果集是否可用了。如果执行的语句并不是返回结果集的类型,我们就知道结果集不可用了。但有时我们不太清楚使用的SQL语句是什么类型,比如说,让用户自行输入SQL语句。这时,我们必须确认是否有结果集被建立,这可以通过<font color="#FFFFCC"><b>SQLNumResultCols</b></font>函数实现。如果结果集存在,则该函数返回结果集中的列数(字段数)。语法如下:</font></p>
<blockquote>
<pre><b><font face="Tahoma" color="#33CCCC">SQLNumResultCols proto StatementHandle:DWORD, pNumCols:DWORD</font></b></pre>
</blockquote>
<ul>
<li><font face="Tahoma" size="-1"><b><font color="#FFCCFF">StatementHandle</font></b>
语句句柄</font></li>
<li><font color="#FFCCFF"><b><font face="Tahoma" size="-1">pNumCols</font></b></font><font face="Tahoma" size="-1">
指向一个双字的指针,其中包含了结果集的列数。</font></li>
</ul>
<p><font face="Tahoma" size="-1">如果<font color="#FFCCFF"><b>
pNumCols</b></font>指向的值为0,那么表明结果集不存在。</font></p>
<h4><font face="Tahoma" color="#FFFFCC">绑定列</font></h4>
<p><font face="Tahoma" size="-1">与绑定一个变量到SQL语句的参数相同,我们连接(绑定)一个变量到结果集中的某一列。这里要用到的函数是<font color="#FFFFCC"><b>SQLBindCol</b></font>,语法如下:</font></p>
<blockquote>
<pre><b><font face="Tahoma" color="#CCFFCC">SQLBindCol proto StatementHandle:DWORD,<br> ColumnNumber:DWORD,<br> TargetType:DWORD,<br> TargetValuePtr:DWORD,<br> BufferLength:DWORD,<br> pStrLenOrIndPtr:DWORD</font></b></pre>
</blockquote>
<ul>
<li><font color="#FFCCFF"><b><font face="Tahoma" size="-1">StatementHandle</font></b></font><font face="Tahoma" size="-1">
语句句柄</font></li>
<li><font color="#FFCCFF"><b><font face="Tahoma" size="-1">ColumnNumber</font></b></font><font face="Tahoma" size="-1">
结果集中要绑定的列序数.列序数从1开始.列0是书签(bookmark)列.</font></li>
<li><font face="Tahoma" size="-1"><b><font color="#FFCCFF">TargetType </font></b>The
指示<font color="#FFCCFF"><b>
TargetValuePtr</b></font>指向的变量(缓冲区)的类型的常数。</font></li>
<li><font face="Tahoma" size="-1"><b><font color="#FFCCFF">TargetValuePtr</font></b>
指向将要捆绑到列的变量或缓冲区的指针。当调用<font color="#FFFFCC"><b>SQLFetch</b></font>来获得结果集中的行时,本参数指向的变量或缓冲区将被填入被绑定的列的值。</font></li>
<li><font color="#FFCCFF"><b><font face="Tahoma" size="-1">BufferLength </font></b></font><font face="Tahoma" size="-1">由<font color="#FFCCFF"><b>TargetValuePtr</b></font>指向的缓冲区的长度。</font></li>
<li><font color="#FFCCFF"><b><font face="Tahoma" size="-1">pStrLenOrIndPtr</font></b></font><font face="Tahoma" size="-1">
参见前章<font color="#FFFFCC"><b>SQLBindParameter</b></font></font></li>
</ul>
<p><font face="Tahoma" size="-1"><b><font color="#33CCCC">例子:</font></b></font></p>
<p><font color="#33CCCC"><b><font face="Tahoma" size="-1">.data?<br>
buffer db 21 dup(?)<br>
DataLength dd ? ;调用SQLFetch后,被填入缓冲区的字符串的长度</font></b></font></p>
<p><font color="#33CCCC"><b><font face="Tahoma" size="-1">.code<br>
.....<br>
invoke SQLBindCol, hStmt, 1, SQL_C_CHAR, addr
buffer, 21, addr DataLength</font></b></font></p>
<h4><font face="Tahoma" color="#FFFFCC">取得一行</font></h4>
<p><font face="Tahoma" size="-1">非常简单.先调用<font color="#FFFFCC"><b>SQLFetch</b></font>
检索结果集的一列到绑定的变量中。当<font color="#FFFFCC"><b>SQLFetch</b></font>调用完成,游标(cursor)被更新(updated).可以认为游标就是一个记录指针(record pointer).
它指明了<font color="#FFFFCC"><b>SQLFetch</b></font>调用后将返回哪一行。比如说,如果结果集有4列,当结果集建立时,游标指向第一行.当调用了<font color="#FFFFCC"><b>SQLFetch</b></font>
后,游标被加1。所以如果调用了<font color="#FFFFCC"><b>SQLFetch
</b></font>4次,就没有更多的行可被提交了。游标会显示指向文件尾(EOF). <font color="#FFFFCC"><b>SQLFetch</b></font>语法如下:</font></p>
<blockquote>
<pre><b><font face="Tahoma" color="#33CCCC">SQLFetch proto StatementHandle:DWORD</font></b></pre>
</blockquote>
<p><font face="Tahoma" size="-1">当没有行可提交时,这个函数返回<font color="#CCFFCC"><b>
SQL_NO_DATA</b></font>.</font></p>
<p><font face="Tahoma" size="-1"><b><font color="#33CCCC">例子:</font></b></font></p>
<p><font color="#33CCCC"><b><font face="Tahoma" size="-1">.data?<br>
buffer db 21 dup(?)<br>
DataLength dd ?</font></b></font></p>
<p><font color="#33CCCC"><b><font face="Tahoma" size="-1">.code<br>
.....<br>
invoke SQLBindCol, hStmt, 1, SQL_C_CHAR, addr
buffer, 21, addr DataLength<br>
invoke SQLFetch, hStmt</font></b></font></p>
<p> </p>
<p> </p><p> </p>
<p><font face="Tahoma" size="-1"><b><font size="+1" color="#FFFFCC">译者废话:</font></b>还记得地球的经纬吗?我们通过<b><font color="#FFFFCC">SQLBindCol</font></b>来定位经度(列),用<b><font color="#FFFFCC">游标</font></b>来定义纬度(行),用<b><font color="#FFFFCC">SQLFetch</font></b>来获得坐标,而<b><font color="#FFFFCC">结果集</font></b>就是地球。大航海时代2的同好们不应忘记呀!(船长,我们找不到水......顺便问一句,这是地球吗%$#@&*^:-)</font></p><font face="Tahoma" size="-1"><font>
<p align="center"><b><font face="Tahoma" size="-1"><a href="odbc-c3.htm">[<<]</a>
<a href="odbc-index.html">[index]</a> <a href="odbc-c5.htm">[>>]</a></font></b></p>
<hr>
<p align="center"><font face="Tahoma" size="-1"><b>[<a href="http://win32asm.cjb.net">Iczelion's
Win32 Assembly Homepage</a>]</b></font></p>
<p align="center"><b><font face="Tahoma" size="-1">[The Chinese Portion Is Translated By <a href="mailto:hw1979@263.net">Orochi</a> ,2000.8.24]</font></b></p>
</font></font></body>
</html>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -