ListViewInsertedEventArgs.KeepInInsertMode Propriété

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

Valeur de propriété

true si les valeurs d'entrée de l'utilisateur sont conservées pour les contrôles à l'intérieur du modèle InsertItemTemplate ; false si les valeurs d'entrée de l'utilisateur sont remplacées par les valeurs par défaut des contrôles. La valeur par défaut est false.

Exemples

L’exemple suivant montre comment utiliser la KeepInInsertMode propriété pour conserver les valeurs entrées par l’utilisateur lorsqu’une erreur se produit pendant l’opération d’insertion. Cet exemple de code fait partie d’un exemple plus grand fourni pour la 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

Remarques

Par défaut, le ListView contrôle réinitialise les valeurs du contrôle du InsertItemTemplate modèle à leurs valeurs par défaut après une opération d’insertion. Cela permet aux utilisateurs d’ajouter des valeurs pour qu’un nouvel élément soit inséré. Si une exception est levée pendant l’opération d’insertion, vous pouvez conserver le ListView contrôle en mode insertion en définissant la KeepInInsertMode propriété sur true. Cela conserve les valeurs de la tentative précédente d’insertion d’un élément pour les contrôles à l’intérieur du InsertItemTemplate modèle.

S’applique à

Voir aussi

• ListView
• Vue d’ensemble de la technologie : contrôle ListView