ListViewInsertedEventArgs.ExceptionHandled Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define a que indica se uma exceção levantada durante a operação de inserção foi tratada no handler de eventos.
public:
property bool ExceptionHandled { bool get(); void set(bool value); };
public bool ExceptionHandled { get; set; }
member this.ExceptionHandled : bool with get, set
Public Property ExceptionHandled As Boolean
Valor de Propriedade
true se a exceção foi tratada no gestor de eventos; caso contrário, false. A predefinição é false.
Exemplos
O exemplo seguinte mostra como usar o ListViewInsertedEventArgs objeto que é passado ao handler para o ItemInserted evento para determinar se uma exceção foi levantada 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
Observações
Quando uma exceção é levantada durante a operação de inserção, use a ExceptionHandled propriedade para indicar se a exceção foi tratada no gestor de eventos. Quando esta propriedade é definida para true, a exceção é considerada tratada e não é relançada. Se esta propriedade for definida para false, o ListView controlo relança a exceção. Para determinar qual exceção foi levantada, use a Exception propriedade.