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

ListViewInsertedEventArgs.AffectedRows Свойство

Определение

Пространство имен:
System.Web.UI.WebControls
Сборка:
System.Web.Extensions.dll

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

public:
 property int AffectedRows { int get(); };
public int AffectedRows { get; }
member this.AffectedRows : int
Public ReadOnly Property AffectedRows As Integer

Значение свойства

Int32

Количество строк, затронутых операцией вставки.

Примеры

В следующем примере показано, как использовать 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 Используйте свойство, чтобы определить количество записей, затронутых операцией вставки, как возвращается элементом управления версиями данных. Это свойство обычно используется в следующих сценариях:

  • Чтобы убедиться, что была вставлена только одна запись. Иногда неправильно написанная инструкция вставки может вставлять несколько записей.

  • Чтобы убедиться, что запись не была вставлена из-за ошибки во время операции вставки, но исключение не было вызвано.

  • Чтобы убедиться, что запись была вставлена, когда элемент управления источником данных, поддерживающий обнаружение конфликтов (оптимистическое параллелизм), имеет значение ConflictDetectionConflictOptions.CompareAllValues перечисления. Элементы управления, поддерживающие это свойство, включают SqlDataSource элементы управления и ObjectDataSource элементы управления. Если свойство имеет это значение, запись может не вставляться, если она имеет то же значение ключа, что и запись, вставленная другим пользователем.

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

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