ListViewInsertedEventArgs.KeepInInsertMode Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает значение, которое позволяет определить, сохраняются ли значения, введенные пользователем, для элементов управления в шаблоне InsertItemTemplate.
public:
property bool KeepInInsertMode { bool get(); void set(bool value); };public bool KeepInInsertMode { get; set; }member this.KeepInInsertMode : bool with get, setPublic 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 шаблона.
