ListViewInsertedEventArgs.KeepInInsertMode Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Eingabewerte des Benutzers für die Steuerelemente innerhalb der InsertItemTemplate Vorlage beibehalten werden.
public:
property bool KeepInInsertMode { bool get(); void set(bool value); };public bool KeepInInsertMode { get; set; }member this.KeepInInsertMode : bool with get, setPublic Property KeepInInsertMode As BooleanEigenschaftswert
true wenn die Eingabewerte des Benutzers für die Steuerelemente innerhalb der InsertItemTemplate Vorlage beibehalten werden. false Wenn die Eingabewerte des Benutzers durch die Standardwerte für die Steuerelemente ersetzt werden. Der Standardwert lautet 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 ListView Steuerelement die Werte des Steuerelements aus der InsertItemTemplate Vorlage nach einem Einfügevorgang auf die Standardwerte zurück. Auf diese Weise können Benutzer Werte hinzufügen, damit ein neues Element eingefügt werden kann. 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 innerhalb der InsertItemTemplate Vorlage einzufügen.
