Freigeben über


ListViewInsertedEventArgs.KeepInInsertMode Eigenschaft

Definition

Ruft einen Wert ab, der angibt, ob die Eingabewerte eines Benutzers für die Steuerelemente in der InsertItemTemplate-Vorlage beibehalten werden, oder legt diesen fest.

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

Eigenschaftswert

true, wenn die Eingabewerte des Benutzers für die Steuerelemente in der InsertItemTemplate-Vorlage beibehalten werden, false, wenn die Eingabewerte des Benutzers durch die Standardwerte für die Steuerelemente ersetzt werden. Der Standardwert ist false.

Beispiele

Das folgende Beispiel zeigt, wie die KeepInInsertMode -Eigenschaft verwendet wird, um die vom Benutzer eingegebenen Werte beizubehalten, wenn während des Einfügevorgangs ein Fehler auftritt. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die ListViewInsertedEventArgs-Klasse bereitgestellt wird.

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

Hinweise

Standardmäßig setzt das Steuerelement die ListView Werte des Steuerelements aus der InsertItemTemplate Vorlage nach einem Einfügevorgang auf ihre Standardwerte zurück. Dadurch können Benutzer Werte für ein neues einzufügende Element hinzufügen. Wenn während des Einfügevorgangs eine Ausnahme ausgelöst wird, können Sie das ListView Steuerelement im Einfügemodus beibehalten, indem Sie die KeepInInsertMode -Eigenschaft auf truefestlegen. Dadurch werden die Werte aus dem vorherigen Versuch beibehalten, ein Element für die Steuerelemente in der InsertItemTemplate Vorlage einzufügen.

Gilt für:

Weitere Informationen