ListViewInsertedEventArgs.KeepInInsertMode Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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, setPublic Property KeepInInsertMode As BooleanValor 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.
