ListViewInsertedEventArgs.AffectedRows Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает количество строк, на которые повлияла операция вставки.
public:
property int AffectedRows { int get(); };public int AffectedRows { get; }member this.AffectedRows : intPublic 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 . Если свойство имеет это значение, запись может не быть вставлена, если она имеет то же значение ключа, что и запись, вставленная другим пользователем.
