BindingSource.AllowNew Özellik

Tanım

Yöntemin AddNew() listeye öğe eklemek için kullanılıp kullanılamayacağını belirten bir değer alır veya ayarlar.

C#
public virtual bool AllowNew { get; set; }

Özellik Değeri

true listeye öğe eklemek için kullanılabiliyorsa AddNew() ; değilse, false.

Özel durumlar

Bu özellik, özelliği tarafından List temsil edilen temel alınan listenin sabit bir boyutu olduğunda veya salt okunur olduğunda olarak ayarlanırtrue.

özelliği olarak ayarlanır true ve AddingNew temel alınan liste türü parametresiz oluşturucuya sahip olmadığında olay işlenmez.

Örnekler

Aşağıdaki kod örneği, kullanıcının bileşenin AllowNewBindingSource temel listesine yeni öğeler eklemesine izin vermek için bileşenin BindingSource özelliğinin kullanılmasını gösterir. Bu özelliğin olarak true ayarlanması, ilişkili DataGridView denetimin yeni kayıtlar için satırını görüntülemesine neden olur.

C#
public Form1()
{
    // Set up the form.
    this.Size = new Size(800, 800);
    this.Load += new EventHandler(Form1_Load);

    // Set up the DataGridView control.
    this.customersDataGridView.AllowUserToAddRows = true;
    this.customersDataGridView.Dock = DockStyle.Fill;
    this.Controls.Add(customersDataGridView);

    // Add the StatusBar control to the form.
    this.Controls.Add(status);

    // Allow the user to add new items.
    this.customersBindingSource.AllowNew = true;

    // Attach an event handler for the AddingNew event.
    this.customersBindingSource.AddingNew +=
        new AddingNewEventHandler(customersBindingSource_AddingNew);

    // Attach an eventhandler for the ListChanged event.
    this.customersBindingSource.ListChanged +=
        new ListChangedEventHandler(customersBindingSource_ListChanged);

    // Attach the BindingSource to the DataGridView.
    this.customersDataGridView.DataSource =
        this.customersBindingSource;
}

Açıklamalar

Özelliğin AllowNew varsayılan değeri, temel alınan veri kaynağı türüne bağlıdır. Temel alınan liste arabirimini uygularsa IBindingList , bu özellik temel alınan listeye temsilci seçer. Aksi takdirde, temel alınan listede aşağıdaki özelliklerden herhangi biri varsa bu özellik döndürülecektir false :

  • Özelliği tarafından belirlenen sabit bir boyuta IList.IsFixedSize sahiptir.

  • Özelliği tarafından IList.IsReadOnly belirlendiği gibi salt okunurdur.

  • Öğenin türünün parametresiz oluşturucu yok.

Not

Bu özelliğin değeri ayarlandıktan sonra, getter artık çağrıyı temel alınan listeye göndermez. Bunun yerine, yöntem çağrılana kadar ResetAllowNew daha önce ayarlanmış olan değeri döndürür.

Bu özelliğin ayarlanması, ile olayının ListChangedListChangedEventArgs.ListChangedType olarak ayarlanmasını ListChangedType.Resetsağlar.

özelliğini true olarak ayarlarsanız AllowNew ve temel alınan liste türü parametresiz bir oluşturucuya sahip değilse, olayı işlemeniz AddingNew ve uygun türü oluşturmanız gerekir.

Şunlara uygulanır

Ürün Sürümler
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10

Ayrıca bkz.