ListViewInsertedEventArgs.AffectedRows Propriedade

Definição

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

Obtém o número de linhas afetadas pela operação de inserção.

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

public int AffectedRows { get; }

member this.AffectedRows : int

Public ReadOnly Property AffectedRows As Integer

Valor da propriedade

Int32

O número de linhas afetadas pela operação de inserção.

Exemplos

O exemplo a seguir mostra como usar o ListViewInsertedEventArgs objeto que é passado para um manipulador para o ItemInserted evento para determinar se uma exceção foi gerada durante a operação de inserção. Este exemplo de código faz parte de um exemplo maior fornecido para a ListViewInsertedEventArgs classe .

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

Comentários

Use a AffectedRows propriedade para determinar o número de registros que foram afetados pela operação de inserção, conforme retornado pelo controle da fonte de dados. Normalmente, essa propriedade é usada nos seguintes cenários:

• Para verificar se apenas um único registro foi inserido. Às vezes, uma instrução de inserção escrita incorretamente pode inserir vários registros.

• Para verificar se um registro não foi inserido porque ocorreu um erro durante a operação de inserção, mas uma exceção não foi gerada.

• Para verificar se um registro foi inserido quando um controle de fonte de dados que dá suporte à detecção de conflitos (simultaneidade otimista) tem sua ConflictDetection propriedade definida como o valor de ConflictOptions.CompareAllValues enumeração. Os controles que dão suporte a essa propriedade incluem os SqlDataSource controles e ObjectDataSource . Quando a propriedade tem esse valor, um registro pode não ser inserido se tiver o mesmo valor de chave que um registro inserido por outro usuário.

Confira também

• ListView
• ItemInserted
• Exception
• ExceptionHandled
• Values
• Visão geral da tecnologia: o controle ListView