DataRepeater.AllowUserToDeleteItems - свойство

Статья
11/05/2008

Обновлен: Ноябрь 2007

Возвращает или задает значение, определяющее возможность пользователя удалять строку из DataRepeater во время выполнения.

Пространство имен: Microsoft.VisualBasic.PowerPacks
Сборка: Microsoft.VisualBasic.PowerPacks.Vs (в Microsoft.VisualBasic.PowerPacks.Vs.dll)

Синтаксис

'Декларация
Public Property AllowUserToDeleteItems As Boolean
'Применение
Dim instance As DataRepeater
Dim value As Boolean

value = instance.AllowUserToDeleteItems

instance.AllowUserToDeleteItems = value

public bool AllowUserToDeleteItems { get; set; }

public:
property bool AllowUserToDeleteItems {
    bool get ();
    void set (bool value);
}

public function get AllowUserToDeleteItems () : boolean
public function set AllowUserToDeleteItems (value : boolean)

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

Тип: System.Boolean
Если пользователь может удалять строки, значение — true, в противном случае — значение false. Значение по умолчанию — true.

Заметки

Если свойству AllowUserToDeleteItems задано значение True, пользователи могут удалять строки, щелкнув BindingNavigatorDeleteItemToolStripButton в элементе управления BindingNavigator или нажав кнопку DELETE, когда DataRepeaterItem имеет фокус.

Если свойству AllowUserToDeleteItems задано значение False, клавиша DELETE не работает, но BindingNavigatorDeleteItemToolStripButton действует по-прежнему. Если нужно запретить пользователям удалять строки, в элементе управления BindingNavigator следует отключить или удалить BindingNavigatorDeleteItemToolStripButton.

Примеры

В следующем примере кода показано отключение кнопки "Удалить" ToolStripButton в случае, когда свойство AllowUserToAddItems имеет значение False. Пример предполагает наличие формы, содержащей элемент управления DataRepeater с именем DataRepeater1 и элемент управления BindingNavigator.

Private Sub DataRepeater1_AllowUserToDeleteItemsChanged _
 (ByVal sender As Object, ByVal e As System.EventArgs) Handles _
  DataRepeater1.AllowUserToDeleteItemsChanged
    ' If this event occurs during form initialization, exit.
    If Me.IsHandleCreated = False Then Exit Sub
    ' If AllowUserToDeleteItems is False.
    If DataRepeater1.AllowUserToDeleteItems = False Then
        ' Disable the Delete button.
        BindingNavigatorDeleteItem.Enabled = False
    Else
        ' Otherwise, enable the Delete button.
        BindingNavigatorDeleteItem.Enabled = True
    End If
End Sub
Private Sub BindingNavigatorDeleteItem_EnabledChanged(ByVal sender _
 As Object, ByVal e As System.EventArgs) Handles _
 BindingNavigatorDeleteItem.EnabledChanged
    If DataRepeater1.AllowUserToDeleteItems = False Then
        ' The BindingSource resets this property when a 
        ' new record is selected, so override it.
        If BindingNavigatorDeleteItem.Enabled = True Then
            BindingNavigatorDeleteItem.Enabled = False
        End If
    End If
End Sub

private void dataRepeater1_AllowUserToDeleteItemsChanged(object sender, System.EventArgs e)
{
    // If this event occurs during form initialization, exit.
    if (this.IsHandleCreated == false) { return; }
    // If AllowUserToDeleteItems is False.
    if (dataRepeater1.AllowUserToDeleteItems == false)
    // Disable the Delete button.
    {
        bindingNavigatorDeleteItem.Enabled = false;
    }
    else
    {
        // Otherwise, enable the Delete button.
        bindingNavigatorDeleteItem.Enabled = true;
    }
}
private void bindingNavigatorDeleteItem_EnabledChanged(object sender, System.EventArgs e)
{
    if (dataRepeater1.AllowUserToDeleteItems == false)
    // The BindingSource resets this property when a 
    // new record is selected, so override it.
    {
        if (bindingNavigatorDeleteItem.Enabled == true)
        {
            bindingNavigatorDeleteItem.Enabled = false;
        }
    }
}

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.