ListViewInsertedEventArgs.KeepInInsertMode 屬性

定義

命名空間:

System.Web.UI.WebControls

組件:

System.Web.Extensions.dll

取得或設定值，指出使用者的輸入值是否保留給 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

屬性值

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 插入控制項專案的值。

另請參閱

• ListView
• 技術概觀：ListView 控件