📄 mdmthcancelbatch.htm

📁 ADO使用手册,非常详细
💻 HTM
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML dir=ltr>
<HEAD>
<META HTTP-EQUIV="Content-Type" Content="text/html; charset=gb2312"><title>CancelBatch 方法</title>
<style>@import url(msdn_ie4.css);</style>
</HEAD>
<BODY>
<h1><a name="mdmthcancelbatch"></a>CancelBatch 方法</h1>

<p>
取消挂起的批更新。</p>
<p class=label>
<b>语法</b></p>
<p>
<i>recordset</i>.<b>CancelBatch</b> <b><i>AffectRecords</i></b></p>
<p class=label>
<b>参数</b></p>
<p>
<b><i>AffectRecords&nbsp;&nbsp;&nbsp;</i></b> 可选的 <b>AffectEnum</b> 值，决定<b> CancelBatch</b> 方法所影响记录的数目，可为下列常量之一：</p>
<table border=1 cellpadding=5 cols=2 frame=below rules=rows>
<tr valign=top>
<td class=label width=25%><b>常量</b></td>
<td class=label width=75%><b>说明</b></td>
</tr>
<tr valign=top>
<td width=25%><b>AdAffectCurrent</b></td>
<td width=75%>仅取消当前记录的挂起更新。</td>
</tr>
<tr valign=top>
<td width=25%><b>AdAffectGroup</b></td>
<td width=75%>对满足当前 <a href="mdprofilter.htm">Filter</a> 属性设置的记录取消挂起更新。使用该选项时，必须将 <b>Filter </b>属性设置为合法的预定义常量之一。</td>
</tr>
<tr valign=top>
<td width=25%><b>AdAffectAll</b></td>
<td width=75%>默认值。取消<b> Recordset</b> 对象中所有记录的挂起更新，包括由当前 <b>Filter </b>属性设置所隐藏的任何记录。</td>
</tr>
</table><br>
<p class=label>
<b>说明</b></p>
<p>
使用<b> CancelBatch</b> 方法可取消批更新模式下记录集中所有挂起的更新。如果记录集处于立即更新模式，调用不带<b> adAffectCurrent</b> 的<b> CancelBatch</b> 将产生错误。</p>
<p>
如果调用<b> CancelBatch</b> 时正在编辑当前记录或添加新记录，则 ADO 首先调用 <a href="mdmthcancelupdate.htm">CancelUpdate</a> 方法取消所有已被缓存的修改，然后取消记录集中挂起的所有更改。</p>
<p>
有可能在<b> CancelBatch</b> 调用后，特别是在添加新记录时无法确定当前记录。为此，在<b> CancelBatch</b> 调用后将当前记录位置设置为记录集中的已知位置是明智的。例如可调用 <a href="mdmthmovefirst.htm">MoveFirst</a> 方法。</p>
<p>
如果由于与基本数据冲突（如记录已被其他用户删除）而导致取消挂起更新失败，则提供者将向 <a href="mdcolerrors.htm">Errors</a> 集合返回警告，但不终止程序的执行。只有当所有请求的记录都发生冲突时才发生运行时错误。使用 <b>Filter</b> 属性 (<b>adFilterAffectedRecords</b>) 和 <a href="mdprostatus.htm">Status</a> 属性可以对冲突记录进行定位。</p>
<center> <A HREF="http://www.51windows.Net">www.51windows.Net</A></center>
<SCRIPT LANGUAGE="JavaScript" src="/log/sitelog2.asp"></SCRIPT>
<script src="script.js"></script></BODY>
</HTML>
⌨️ 快捷键说明

复制代码 Ctrl + C
搜索代码 Ctrl + F
全屏模式 F11
切换主题 Ctrl + Shift + D
显示快捷键 ?
增大字号 Ctrl + =
减小字号 Ctrl + -