BindingList<T>.AllowNew Свойство

Определение

Получает или задает значение, показывающее, можно ли добавлять элементы в список с помощью метода AddNew().

public:
 property bool AllowNew { bool get(); void set(bool value); };
public bool AllowNew { get; set; }
member this.AllowNew : bool with get, set
Public Property AllowNew As Boolean

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

Значение true, если можно добавить элементы в список с помощью метода AddNew(); в противном случае — значение false. Значение по умолчанию зависит от базового типа, содержащегося в списке.

Примеры

В следующем примере кода показано, как задать AllowNew свойство . Полный пример см. в BindingList<T> разделе обзора класса.

    // Declare a new BindingListOfT with the Part business object.
    BindingList<Part> listOfParts; 
    private void InitializeListOfParts()
    {
        // Create the new BindingList of Part type.
        listOfParts = new BindingList<Part>();

        // Allow new parts to be added, but not removed once committed.        
        listOfParts.AllowNew = true;
        listOfParts.AllowRemove = false;

        // Raise ListChanged events when new parts are added.
        listOfParts.RaiseListChangedEvents = true;

        // Do not allow parts to be edited.
        listOfParts.AllowEdit = false;
        
        // Add a couple of parts to the list.
        listOfParts.Add(new Part("Widget", 1234));
        listOfParts.Add(new Part("Gadget", 5647));
    }
' Declare a new BindingListOfT with the Part business object.
Private WithEvents listOfParts As BindingList(Of Part)

Private Sub InitializeListOfParts()

    ' Create the new BindingList of Part type.
    listOfParts = New BindingList(Of Part)

    ' Allow new parts to be added, but not removed once committed.        
    listOfParts.AllowNew = True
    listOfParts.AllowRemove = False

    ' Raise ListChanged events when new parts are added.
    listOfParts.RaiseListChangedEvents = True

    ' Do not allow parts to be edited.
    listOfParts.AllowEdit = False

    ' Add a couple of parts to the list.
    listOfParts.Add(New Part("Widget", 1234))
    listOfParts.Add(New Part("Gadget", 5647))

End Sub

Комментарии

Свойство AllowNew обычно используется другими компонентами, чтобы определить, разрешено ли создание новых элементов. AllowNew значение по умолчанию , true если тип, содержащийся в списке, имеет конструктор без параметров или AddingNew событие обрабатывается. AddingNew Если событие не обрабатывается или тип списка не имеет конструктора без параметров, по AllowNew умолчанию используется значение false.

Если AllowNew задан явным образом, заданное значение всегда будет использоваться привязанными объектами для определения возможности добавления новых элементов в список. Независимо от того, имеет ли AllowNew значение true или false, новые элементы можно добавить путем явного вызова AddNew , если тип списка имеет конструктор без параметров или AddingNew событие обрабатывается. Кроме того, параметр AllowNew вызывает ListChanged событие типа Reset .

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

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