Udostępnij za pośrednictwem


ListViewInsertedEventArgs.KeepInInsertMode Właściwość

Definicja

Pobiera lub ustawia wartość wskazującą, czy wartości wejściowe użytkownika są zachowywane dla kontrolek wewnątrz szablonu 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

Wartość właściwości

true jeśli wartości wejściowe użytkownika są zachowywane dla kontrolek wewnątrz InsertItemTemplate szablonu; false jeśli wartości wejściowe użytkownika zostaną zastąpione wartościami domyślnymi kontrolek. Wartość domyślna to false.

Przykłady

W poniższym przykładzie pokazano, jak za pomocą KeepInInsertMode właściwości zachować wartości wprowadzone przez użytkownika w przypadku wystąpienia błędu podczas operacji wstawiania. Ten przykład kodu jest częścią większego przykładu podanego ListViewInsertedEventArgs dla klasy.

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

Uwagi

Domyślnie kontrolka ListView resetuje wartości kontrolki z szablonu InsertItemTemplate do wartości domyślnych po operacji wstawiania. Dzięki temu użytkownicy mogą dodawać wartości dla nowego elementu do wstawienia. Jeśli podczas operacji wstawiania zostanie zgłoszony wyjątek, możesz zachować kontrolkę ListView w trybie wstawiania, ustawiając KeepInInsertMode właściwość na true. Zachowuje to wartości z poprzedniej próby wstawienia elementu dla kontrolek wewnątrz szablonu InsertItemTemplate .

Dotyczy

Zobacz też