ListViewInsertedEventArgs.KeepInInsertMode Egenskap

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

Egenskapsvärde

true om användarens indatavärden bevaras för kontrollerna i mallen InsertItemTemplate . false Om användarens indatavärden ersätts med standardvärdena för kontrollerna. Standardvärdet är false.

Exempel

I följande exempel visas hur du använder KeepInInsertMode egenskapen för att bevara de värden som användaren anger när ett fel inträffar under infogningsåtgärden. Det här kodexemplet är en del av ett större exempel för ListViewInsertedEventArgs klassen.

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

Kommentarer

Som standard ListView återställer kontrollen kontrollens värden från mallen InsertItemTemplate till standardvärdena efter en infogningsåtgärd. Detta gör det möjligt för användare att lägga till värden för ett nytt objekt som ska infogas. Om ett undantag utlöses under infogningsåtgärden ListView kan du behålla kontrollen i infogningsläge genom att ange KeepInInsertMode egenskapen till true. Detta behåller värdena från föregående försök att infoga ett objekt för kontrollerna i mallen InsertItemTemplate .

Se även

• ListView
• Tekniköversikt: ListView-kontrollen