BindingList<T>.AllowNew 属性

定义

命名空间:

System.ComponentModel

程序集:

System.ComponentModel.TypeConverter.dll

Source:

BindingList.cs

获取或设置一个值，该值指示是否可以使用 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

属性值

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

另请参阅

• AddNew()
• AllowEdit
• AllowRemove