语言

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

适用于

另请参阅