ListViewInsertedEventArgs.KeepInInsertMode Свойство

Определение

Получает или задает значение, которое позволяет определить, сохраняются ли значения, введенные пользователем, для элементов управления в шаблоне 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

Значение свойства

Значение 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 шаблона.

Применяется к

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