Поделиться через


ListViewInsertedEventArgs.AffectedRows Свойство

Определение

Возвращает количество строк, на которые повлияла операция вставки.

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 . Если свойство имеет это значение, запись может не быть вставлена, если она имеет то же значение ключа, что и запись, вставленная другим пользователем.

Применяется к

См. также раздел