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

Статья
11/05/2008

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

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

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

Синтаксис

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

value = instance.AllowUserToAddItems

instance.AllowUserToAddItems = value

public bool AllowUserToAddItems { get; set; }

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

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

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

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

Заметки

Если свойству AllowUserToAddItems задано значение True, пользователи могут добавлять строки, щелкнув BindingNavigatorAddNewItemToolStripButton в элементе управления BindingNavigator или нажав сочетание клавиш CTRL+N, когда DataRepeaterItem имеет фокус.

Если свойству AllowUserToAddItems задано значение False, сочетание клавиш CTRL+N не работает, но BindingNavigatorAddNewItemToolStripButton действует по-прежнему. Если нужно запретить пользователям добавлять строки, в элементе управления BindingNavigator следует отключить или удалить BindingNavigatorAddNewItemToolStripButton.

Примеры

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

Private Sub DataRepeater1_AllowUserToAddItemsChanged(ByVal sender _
 As Object, ByVal e As System.EventArgs) Handles _
 DataRepeater1.AllowUserToAddItemsChanged
    ' If this event occurs during form initialization, exit.
    If Me.IsHandleCreated = False Then Exit Sub
    ' If AllowUserToAddItems is False.
    If DataRepeater1.AllowUserToAddItems = False Then
        ' Disable the Add button.
        BindingNavigatorAddNewItem.Enabled = False
        ' Disable the BindingSource property.
        ProductsBindingSource.AllowNew = False
    Else
        ' Otherwise, enable the Add button.
        BindingNavigatorAddNewItem.Enabled = True
    End If
End Sub

private void dataRepeater1_AllowUserToAddItemsChanged(object sender, System.EventArgs e)
{
    // If this event occurs during form initialization, exit.
    if (this.IsHandleCreated == false) { return; }
    // If AllowUserToAddItems is False.
    if (dataRepeater1.AllowUserToAddItems == false)
    // Disable the Add button.
    {
        bindingNavigatorAddNewItem.Enabled = false;
        // Disable the BindingSource property.
        productsBindingSource.AllowNew = false;
    }
    else
    {
        // Otherwise, enable the Add button.
        bindingNavigatorAddNewItem.Enabled = true;
    }
}

Разрешения

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