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

Комментарии

По умолчанию элемент управления сбрасывает значения элемента управления из InsertItemTemplate шаблона в значения по умолчанию ListView после операции вставки. Это позволяет пользователям добавлять значения для вставки нового элемента. Если во время операции вставки возникает исключение, можно сохранить ListView элемент управления в режиме вставки, задав для свойства значение KeepInInsertModetrue. Это сохраняет значения из предыдущей попытки вставить элемент для элементов управления внутри InsertItemTemplate шаблона.

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

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