Compartilhar via


ListViewInsertedEventArgs.KeepInInsertMode Propriedade

Definição

Obtém ou define um valor que indica se os valores de entrada do usuário são preservados para os controles dentro do modelo InsertItemTemplate.

public:
 property bool KeepInInsertMode { bool get(); void set(bool value); };
public bool KeepInInsertMode { get; set; }
member this.KeepInInsertMode : bool with get, set
Public Property KeepInInsertMode As Boolean

Valor 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 um novo item a ser 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 truecomo . Isso mantém os valores da tentativa anterior de inserir um item para os controles dentro do InsertItemTemplate modelo.

Aplica-se a

Confira também