Compartir a través de


ListViewInsertedEventArgs.AffectedRows Propiedad

Definición

Obtiene el número de filas afectadas por la inserción.

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

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

  • Para comprobar que solo se insertó 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 un registro no se inserte si tiene el mismo valor de clave que un registro insertado por otro usuario.

Se aplica a

Consulte también