共用方式為


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

適用於

另請參閱