Compartir a través de


ListViewInsertedEventArgs.KeepInInsertMode Propiedad

Definición

Obtiene o establece un valor que indica si los valores de entrada del usuario se conservan para los controles dentro de la plantilla 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 de propiedad

Es true si los valores de entrada del usuario se conservan para los controles dentro de la plantilla InsertItemTemplate; es false si los valores de entrada del usuario se reemplazan con los valores predeterminados para los controles. De manera predeterminada, es false.

Ejemplos

En el ejemplo siguiente se muestra cómo usar la KeepInInsertMode propiedad para conservar los valores especificados por el usuario cuando se produce un error durante la operación de inserción. Este ejemplo de código es parte de un ejemplo más grande proporcionado para la clase ListViewInsertedEventArgs.

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

Comentarios

De forma predeterminada, el ListView control restablece los valores del control de la InsertItemTemplate plantilla a sus valores predeterminados después de una operación de inserción. Esto permite a los usuarios agregar valores para que se inserte un nuevo elemento. Si se produce una excepción durante la operación de inserción, puede mantener el ListView control en modo de inserción estableciendo la KeepInInsertMode propiedad trueen . Esto mantiene los valores del intento anterior de insertar un elemento para los controles dentro de la InsertItemTemplate plantilla.

Se aplica a

Consulte también