ListViewUpdatedEventArgs.AffectedRows Propriedade
Definição
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 atualização.
public:
property int AffectedRows { int get(); };
public int AffectedRows { get; }
member this.AffectedRows : int
Public ReadOnly Property AffectedRows As Integer
Valor da propriedade
O número de linhas afetadas pela operação de atualização.
Exemplos
O exemplo a seguir mostra como usar a AffectedRows propriedade para verificar se 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
Comentários
Use a AffectedRows propriedade para determinar o número de linhas que foram afetadas pela operação de atualização, conforme retornado pela fonte de dados. Como normalmente apenas um item é atualizado, essa propriedade geralmente contém um valor de 0 ou 1.
Às 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.