BindingList<T>.AllowNew Properti

Definisi

Ruang nama:

System.ComponentModel

Rakitan:

System.ComponentModel.TypeConverter.dll

Sumber:

BindingList.cs

Mendapatkan atau menetapkan nilai yang menunjukkan apakah Anda dapat menambahkan item ke daftar menggunakan AddNew() metode .

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

Nilai Properti

Boolean

true jika Anda dapat menambahkan item ke daftar dengan AddNew() metode ; jika tidak, false. Default tergantung pada jenis yang mendasar yang terkandung dalam daftar.

Contoh

Contoh kode berikut menunjukkan cara mengatur AllowNew properti . Untuk contoh lengkapnya, lihat BindingList<T> topik gambaran umum kelas.

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

Keterangan

Properti AllowNew biasanya digunakan oleh komponen lain untuk menentukan apakah pembuatan item baru diizinkan. AllowNew default ke true jika jenis yang terkandung dalam daftar memiliki konstruktor tanpa parameter atau peristiwa ditangani AddingNew . AddingNew Jika peristiwa tidak ditangani atau jenis daftar tidak memiliki konstruktor tanpa parameter, maka AllowNew default ke false.

Jika AllowNew diatur secara eksplisit, nilai yang ditetapkan akan selalu digunakan oleh objek terikat untuk menentukan apakah item baru dapat ditambahkan ke daftar. Apakah AllowNew adalah true atau false, item baru dapat ditambahkan dengan secara eksplisit memanggil AddNew jika jenis daftar memiliki konstruktor tanpa parameter atau peristiwa ditangani AddingNew . Selain itu, pengaturan AllowNew menyebabkan ListChanged peristiwa jenis Reset terjadi.

Lihat juga

• AddNew()
• AllowEdit
• AllowRemove