BindingList<T>.AllowNew Vlastnost

Definice

Obor názvů:

System.ComponentModel

Sestavení:

netstandard.dll, System.ComponentModel.TypeConverter.dll

Zdroj:

BindingList.cs

Získá nebo nastaví hodnotu označující, zda lze přidat položky do seznamu pomocí 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

Hodnota vlastnosti

Boolean

true pokud lze přidat položky do seznamu pomocí AddNew() metody; jinak , false. Výchozí nastavení závisí na základním typu obsaženém v seznamu.

Příklady

Následující příklad kódu ukazuje, jak nastavit AllowNew vlastnost. Úplný příklad najdete v tématu přehledu BindingList<T> třídy.

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

Poznámky

Vlastnost AllowNew obvykle používají jiné komponenty k určení, zda je vytváření nových položek povoleno. AllowNew true pokud typ obsažený v seznamu obsahuje konstruktor bez parametrů nebo AddingNew je zpracována událost. AddingNew Pokud událost není zpracována nebo typ seznamu nemá konstruktor bez parametrů, je AllowNew výchozí hodnota false.

Pokud AllowNew je explicitně nastavena, bude nastavená hodnota vždy použita vázané objekty k určení, zda lze do seznamu přidat nové položky. Bez ohledu na to, zda AllowNew je true nebo false, lze nové položky přidat explicitně voláním AddNew , pokud typ seznamu má konstruktor bez parametrů nebo AddingNew je zpracována událost. Kromě toho nastavení AllowNew způsobí ListChanged , že dojde k události typu Reset .

Viz také

• AddNew()
• AllowEdit
• AllowRemove