BindingList<T>.AllowNew 屬性

定義

命名空間:

System.ComponentModel

組件:

System.ComponentModel.TypeConverter.dll

來源:

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 已明確設定，系結物件一律會使用 set 值，以判斷是否可以將新專案新增至清單。 不論 是 AllowNewtrue 或 false，如果清單類型有無參數建構函式或處理事件，AddingNew可以明確呼叫 AddNew 來加入新的專案。 此外，設定 AllowNew 會導致 ListChanged 類型為 Reset 的事件發生。

另請參閱

• AddNew()
• AllowEdit
• AllowRemove