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

属性值

如果可以使用 AddNew() 方法向列表中添加项,则为 true;否则为 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 通常由其他组件用于确定是否允许创建新项。 AllowNewtrue如果列表中包含的类型具有无参数构造函数或已处理事件,AddingNew则默认为 。 如果未处理事件 AddingNew 或列表类型没有无参数构造函数,则 AllowNew 默认为 false

如果 AllowNew 显式设置,则绑定对象将始终使用设置值来确定是否可以将新项添加到列表中。 AllowNew无论是 是 true 还是 false,如果列表类型具有无参数构造函数或事件已处理,AddingNew则可以通过显式调用AddNew来添加新项。 此外,设置 AllowNew 会导致 ListChanged 发生类型 Reset 为的事件。

适用于

另请参阅