ListViewInsertedEventArgs.AffectedRows Propriedade

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.Extensions.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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.

Aplica-se a

Partilhar via