BindingList<T>.AllowNew Właściwość

Definicja

Przestrzeń nazw:

System.ComponentModel

Zestaw:

System.ComponentModel.TypeConverter.dll

Źródło:

BindingList.cs

Pobiera lub ustawia wartość wskazującą, czy można dodać elementy do listy przy użyciu AddNew() metody .

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

Wartość właściwości

Boolean

true jeśli możesz dodać elementy do listy za pomocą AddNew() metody ; falsew przeciwnym razie . Wartość domyślna zależy od bazowego typu znajdującego się na liście.

Przykłady

W poniższym przykładzie kodu pokazano, jak ustawić AllowNew właściwość. Aby zapoznać się z kompletnym przykładem, zobacz BindingList<T> temat omówienie klasy.

    // 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

Uwagi

Właściwość AllowNew jest zwykle używana przez inne składniki w celu określenia, czy tworzenie nowych elementów jest dozwolone. AllowNew wartość domyślna to true , jeśli typ zawarty na liście ma konstruktor bez parametrów lub AddingNew zdarzenie jest obsługiwane. AddingNew Jeśli zdarzenie nie jest obsługiwane lub typ listy nie ma konstruktora bez parametrów, wartość AllowNew domyślna to false.

Jeśli AllowNew zostanie jawnie ustawiona, ustawiona wartość będzie zawsze używana przez powiązane obiekty w celu określenia, czy nowe elementy można dodać do listy. Niezależnie od tego, czy AllowNew element jest truefalseczy , można dodać nowe elementy, jawnie wywołując AddNew , jeśli typ listy ma konstruktor bez parametrów lub AddingNew zdarzenie jest obsługiwane. Ponadto ustawienie AllowNew powoduje ListChanged wystąpienie zdarzenia typu Reset .

Zobacz też

• AddNew()
• AllowEdit
• AllowRemove