ListViewInsertedEventArgs.KeepInInsertMode 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得或設定值,指出使用者的輸入值是否保留給 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
屬性值
如果使用者的輸入值保留給 InsertItemTemplate 範本內的控制項則為 true
,而如果使用者的輸入值會替換為控制項的預設值則為 false
。 預設為 false
。
範例
下列範例示範如何在插入作業期間發生錯誤時,使用 KeepInInsertMode 屬性來保留使用者輸入的值。 此程式碼範例是提供給 類別之較大範例的 ListViewInsertedEventArgs 一部分。
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
備註
根據預設, ListView 控制項會在插入作業之後,將控制項的值從 InsertItemTemplate 範本重設為預設值。 這可讓使用者新增要插入之新專案的值。 如果在插入作業期間引發例外狀況,您可以將 屬性設定 KeepInInsertMode 為 true
,讓控制項保持 ListView 插入模式。 這會維護先前嘗試在範本內 InsertItemTemplate 插入控制項專案的值。
適用於
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應