BindingList<T>.AllowNew Propriété

Définition

Espace de noms:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Source:

BindingList.cs

Obtient ou définit une valeur indiquant si vous pouvez ajouter des éléments à la liste à l'aide de la méthode 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

Valeur de propriété

Boolean

true si vous pouvez ajouter des éléments à la liste à l'aide de la méthode AddNew() ; sinon, false. La valeur par défaut dépend du type sous-jacent contenu dans la liste.

Exemples

L’exemple de code suivant montre comment définir la AllowNew propriété . Pour obtenir l’exemple complet, consultez la rubrique Vue d’ensemble de la BindingList<T> classe.

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

Remarques

La AllowNew propriété est généralement utilisée par d’autres composants pour déterminer si la création de nouveaux éléments est autorisée. AllowNew la valeur par défaut est true si le type contenu dans la liste a un constructeur sans paramètre ou si l’événement AddingNew est géré. Si l’événement AddingNew n’est pas géré ou si le type de liste n’a pas de constructeur sans paramètre, la AllowNew valeur par défaut est false.

Si AllowNew est défini explicitement, la valeur définie sera toujours utilisée par les objets liés pour déterminer si de nouveaux éléments peuvent être ajoutés à la liste. Si AllowNew est true ou false, de nouveaux éléments peuvent être ajoutés en appelant AddNew explicitement si le type de liste a un constructeur sans paramètre ou si l’événement AddingNew est géré. En outre, la définition AllowNew provoque la survenue d’un ListChanged événement de type Reset .

Voir aussi

• AddNew()
• AllowEdit
• AllowRemove