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

Значение true, если значения, введенные пользователем, сохраняются для элементов управления в шаблоне InsertItemTemplate; значение 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 шаблона в значения по умолчанию после операции вставки. Это позволяет пользователям добавлять значения для нового элемента, который будет вставлен. Если во время операции вставки возникает исключение, можно сохранить ListView элемент управления в режиме KeepInInsertMode вставки, задав для свойства значение true. При этом сохраняются значения из предыдущей попытки вставки элемента для элементов управления внутри InsertItemTemplate шаблона.

См. также раздел

• ListView
• Общие сведения о технологии: элемент управления ListView