ListViewInsertedEventArgs.KeepInInsertMode Propriedade

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 de Propriedade

true se os valores de entrada do utilizador forem preservados para os controlos dentro do InsertItemTemplate modelo; false se os valores de entrada do utilizador forem substituídos pelos valores padrão dos controlos. A predefinição é false.

Exemplos

O exemplo seguinte mostra como usar a KeepInInsertMode propriedade para preservar os valores introduzidos pelo utilizador 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

Observações

Por defeito, o controlo ListView repõe os valores do controlo do InsertItemTemplate template para os valores predefinidos após uma operação de inserção. Isto permite aos utilizadores adicionar valores para que um novo item seja inserido. Se uma exceção for levantada durante a operação de inserção, pode manter o ListView controlo em modo de inserção definindo a KeepInInsertMode propriedade para true. Isto mantém os valores da tentativa anterior de inserir um item para os controlos dentro do InsertItemTemplate template.

Ver também

• ListView
• Visão Geral da Tecnologia: O Controlo ListView