Condividi tramite


ListViewInsertedEventArgs.KeepInInsertMode Proprietà

Definizione

Ottiene o imposta un valore che indica se i valori di input dell'utente vengono mantenuti per i controlli all'interno del modello 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

Valore della proprietà

true se i valori di input vengono mantenuti per i controlli all'interno del modello InsertItemTemplate; false se i valori di input dell'utente vengono sostituiti con i valori predefiniti per i controlli. Il valore predefinito è false.

Esempio

Nell'esempio seguente viene illustrato come usare la KeepInInsertMode proprietà per mantenere i valori immessi dall'utente quando si verifica un errore durante l'operazione di inserimento. Questo esempio di codice fa parte di un esempio più grande fornito per 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

Commenti

Per impostazione predefinita, il ListView controllo reimposta i valori del controllo dal InsertItemTemplate modello ai valori predefiniti dopo un'operazione di inserimento. Ciò consente agli utenti di aggiungere valori per l'inserimento di un nuovo elemento. Se viene generata un'eccezione durante l'operazione di inserimento, è possibile mantenere il ListView controllo in modalità di inserimento impostando la KeepInInsertMode proprietà su true. Ciò mantiene i valori del tentativo precedente di inserire un elemento per i controlli all'interno del InsertItemTemplate modello.

Si applica a

Vedi anche