Form.BeforeInsert 事件 (Access)

插入 事件发生时用户键入第一个字符的新记录，但在实际创建该记录之前。

语法

表达式。BeforeInsert (取消)

expression：表示 Form 对象的变量。

参数

名称	必需/可选	数据类型	说明
Cancel	必需	Integer	该设置确定是否发生 BeforeInsert 事件。 将 Cancel 参数设置为 True (1) 将取消 BeforeInsert 事件。

备注

注意

在使用宏或 Visual Basic 设置控件值时，不会触发此事件。

若要在这些事件发生时运行宏或事件过程，请将 BeforeInsert 或 AfterInsert 属性设置为宏的名称或设置为 [事件过程]。

每当添加新记录时，使用 AfterInsert 事件过程或宏重新查询记录集。

BeforeInsert 和 AfterInsert 事件类似于 BeforeUpdate 和 AfterUpdate 事件。 这些事件按照下列顺序发生：

BeforeInsert → BeforeUpdate → AfterUpdate → AfterInsert

下表总结了这些事件的交互操作：

Event	发生时间
BeforeInsert	用户在新记录中键入第一个字符。
BeforeUpdate	用户更新记录。
AfterUpdate	记录更新后。
AfterInsert	更新的记录是一条新记录。

如果在文本框或组合框中键入新记录中的第一个字符， 则 BeforeInsert 事件在 Change 事件之前发生。

示例

此示例演示如何使用 BeforeInsert 事件过程来验证用户是否希望创建新记录，如何使用 AfterInsert 事件过程在添加记录后重新查询 Employees 窗体的记录源。

若要尝试此示例，请将以下事件过程添加到基于表或查询的名为 Employees 的窗体中。 切换到窗体“数据表”视图并且试着插入一条记录。

Private Sub Form_BeforeInsert(Cancel As Integer) 
 If MsgBox("Insert new record here?", _ 
 vbOKCancel) = vbCancel Then 
 Cancel = True 
 End If 
End Sub 
 
Private Sub Form_AfterInsert() 
 Forms!Employees.Requery 
End Sub

支持和反馈

有关于 Office VBA 或本文档的疑问或反馈？ 请参阅 Office VBA 支持和反馈，获取有关如何接收支持和提供反馈的指南。