ListViewUpdatedEventArgs.AffectedRows Propriedade

Definição

Espaço de Nomes:
System.Web.UI.WebControls
Assemblagem:
System.Web.Extensions.dll

Obtém o número de linhas que foram afetadas pela operação de atualização.

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

Valor de Propriedade

Int32

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

Exemplos

O exemplo seguinte mostra como usar a AffectedRows propriedade para verificar que um item foi atualizado. Este exemplo de código faz parte de um exemplo maior fornecido para a ListViewUpdatedEventArgs classe.

void ContactsListView_ItemUpdated(Object sender, ListViewUpdatedEventArgs e)
{
    if (e.Exception != null)
    {
        if (e.AffectedRows == 0)
        {
            e.KeepInEditMode = true;
            Message.Text = "An exception occurred updating the contact. " +
                                "Please verify your values and try again.";
        }
        else
            Message.Text = "An exception occurred updating the contact. " +
                                "Please verify the values in the recently updated item.";

        e.ExceptionHandled = true;
    }
}

Sub ContactsListView_ItemUpdated(sender As Object, e As ListViewUpdatedEventArgs)
    If e.Exception IsNot Nothing Then
        If e.AffectedRows = 0 Then
            e.KeepInEditMode = True
            Message.Text = "An exception occurred updating the contact. " & _
                                "Please verify your values and try again."
        Else
            Message.Text = "An exception occurred updating the contact. " & _
                                "Please verify the values in the recently updated item."
        End If

        e.ExceptionHandled = True
    End If
End Sub

Observações

Use a AffectedRows propriedade para determinar o número de linhas afetadas pela operação de atualização, conforme devolvido pela fonte de dados. Como normalmente apenas um item é atualizado, esta propriedade normalmente contém um valor de 0 ou 1.

Por vezes, durante a operação de atualização, pode ocorrer um erro que não gera uma exceção. Nesse caso, a AffectedRows propriedade pode ser usada para verificar se um item foi atualizado.

Aplica-se a

Ver também