ListViewInsertedEventArgs.AffectedRows 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取受插入操作影响的行数。
public:
property int AffectedRows { int get(); };
public int AffectedRows { get; }
member this.AffectedRows : int
Public ReadOnly Property AffectedRows As Integer
属性值
受插入操作影响的行数。
示例
下面的示例演示如何使用 ListViewInsertedEventArgs 传递给 事件的处理程序 ItemInserted 的对象来确定插入操作期间是否引发了异常。 此代码示例是为 ListViewInsertedEventArgs 类提供的一个更大示例的一部分。
void ContactsListView_ItemInserted(Object sender, ListViewInsertedEventArgs e)
{
if (e.Exception != null)
{
if (e.AffectedRows == 0)
{
e.KeepInInsertMode = true;
Message.Text = "An exception occurred inserting the new Contact. " +
"Please verify your values and try again.";
}
else
Message.Text = "An exception occurred inserting the new Contact. " +
"Please verify the values in the newly inserted item.";
e.ExceptionHandled = true;
}
}
Sub ContactsListView_ItemInserted(ByVal sender As Object, ByVal e As ListViewInsertedEventArgs)
If e.Exception IsNot Nothing Then
If e.AffectedRows = 0 Then
e.KeepInInsertMode = True
Message.Text = "An exception occurred inserting the new Contact. " & _
"Please verify your values and try again."
Else
Message.Text = "An exception occurred inserting the new Contact. " & _
"Please verify the values in the newly inserted item."
End If
e.ExceptionHandled = True
End If
End Sub
注解
AffectedRows使用 属性可确定数据源控件返回的插入操作影响的记录数。 此属性通常用于以下方案:
验证是否只插入了一条记录。 有时,错误写入的 insert 语句可能会插入多条记录。
验证是否未插入记录,因为插入操作期间发生错误,但未引发异常。
若要验证在支持冲突检测的数据源控件 (乐观并发) 其 ConflictDetection 属性设置为
ConflictOptions.CompareAllValues
枚举值时是否插入了记录。 支持此属性的控件包括 SqlDataSource 和 ObjectDataSource 控件。 当 属性具有此值时,如果记录的键值与其他用户插入的记录相同,则可能不会插入该记录。