Поделиться через


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;
void InitializeListOfParts()
{
    // Create the new BindingList of Part type.
    listOfParts = new BindingList<Part>
    {
        // Allow new parts to be added, but not removed once committed.        
        AllowNew = true,
        AllowRemove = false,

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

        // Do not allow parts to be edited.
        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 того, можно ли добавлять новые элементы путем явного вызоваAddNew, если тип списка имеет конструктор без параметров или AddingNew событие обрабатывается.truefalse Кроме того, установка AllowNew приводит ListChanged к возникновению события типа Reset .

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

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