ListViewInsertedEventArgs.AffectedRows Propiedad

public:
 property int AffectedRows { int get(); };

public int AffectedRows { get; }

member this.AffectedRows : int

Public ReadOnly Property AffectedRows As Integer

Valor de propiedad

Número de filas afectadas por la inserción.

Ejemplos

En el ejemplo siguiente se muestra cómo usar el ListViewInsertedEventArgs objeto que se pasa a un controlador para el ItemInserted evento para determinar si se generó una excepción durante la operación de inserción. Este ejemplo de código es parte de un ejemplo más grande proporcionado para la clase 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

Comentarios

Use la AffectedRows propiedad para determinar el número de registros afectados por la operación de inserción, tal como lo devuelve el control de origen de datos. Esta propiedad se usa normalmente en los escenarios siguientes:

• Para comprobar que solo se ha insertado un único registro. A veces, una instrucción insert escrita incorrectamente puede insertar varios registros.

• Para comprobar que no se insertó un registro porque se produjo un error durante la operación de inserción, pero no se generó una excepción.

• Para comprobar que se insertó un registro cuando un control de origen de datos que admite la detección de conflictos (simultaneidad optimista) tiene su ConflictDetection propiedad establecida en el valor de ConflictOptions.CompareAllValues enumeración. Los controles que admiten esta propiedad incluyen los SqlDataSource controles y ObjectDataSource . Cuando la propiedad tiene este valor, es posible que no se inserte un registro si tiene el mismo valor de clave que un registro insertado por otro usuario.

Se aplica a

Consulte también

• ListView
• ItemInserted
• Exception
• ExceptionHandled
• Values
• Información general sobre la tecnología: control ListView