ListViewInsertedEventArgs.KeepInInsertMode 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 ou define um valor que indica se os valores de entrada do usuário são preservados para os controles dentro do InsertItemTemplate modelo.
public:
property bool KeepInInsertMode { bool get(); void set(bool value); };public bool KeepInInsertMode { get; set; }member this.KeepInInsertMode : bool with get, setPublic Property KeepInInsertMode As BooleanValor da propriedade
true se os valores de entrada do usuário forem preservados para os controles dentro do InsertItemTemplate modelo; false se os valores de entrada do usuário forem substituídos pelos valores padrão para os controles. O padrão é false.
Exemplos
O exemplo a seguir mostra como usar a KeepInInsertMode propriedade para preservar os valores inseridos pelo usuário quando ocorre um erro 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
Por padrão, o ListView controle redefine os valores do controle do InsertItemTemplate modelo para seus valores padrão após uma operação de inserção. Isso permite que os usuários adicionem valores para que um novo item seja inserido. Se uma exceção for gerada durante a operação de inserção, você poderá manter o ListView controle no modo de inserção definindo a KeepInInsertMode propriedade como true. Isso mantém os valores da tentativa anterior de inserir um item para os controles dentro do InsertItemTemplate modelo.
