BindingList<T>.AllowNew Özellik

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

Özellik Değeri

true yöntemiyle AddNew() listeye öğe ekleyebiliyorsanız; değilse, false. Varsayılan değer, listede yer alan temel türe bağlıdır.

Örnekler

Aşağıdaki kod örneği özelliğin nasıl ayarlandığını AllowNew gösterir. Tam örnek için sınıfa genel bakış konusuna BindingList<T> bakın.

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

Açıklamalar

AllowNew özelliği genellikle yeni öğelerin oluşturulmasına izin verilip verilmediğini belirlemek için diğer bileşenler tarafından kullanılır. AllowNewtrue, listede yer alan türün parametresiz bir oluşturucuya sahip olması veya AddingNew olayın işlenmesi durumunda varsayılan olarak ayarlanır. AddingNew Olay işlenmediyse veya liste türünün parametresiz oluşturucu yoksa, AllowNew varsayılan olarak falseolur.

Açıkça ayarlanırsa AllowNew , küme değeri her zaman bağlı nesneler tarafından listeye yeni öğelerin eklenip eklenebileceğini belirlemek için kullanılır. veya falseolsun trueAllowNew, liste türü parametresiz bir oluşturucuya sahipse veya olay işlenirse açıkça çağrılarak AddNewAddingNew yeni öğeler eklenebilir. Buna ek olarak, ayar AllowNew türünde Reset bir ListChanged olayın gerçekleşmesine neden olur.

Şunlara uygulanır

Ayrıca bkz.

• AddNew()
• AllowEdit
• AllowRemove