AddingNewEventHandler Temsilci

Tanım

Ad Alanı:

System.ComponentModel

Bütünleştirilmiş Kod:

System.ComponentModel.TypeConverter.dll

Olayı işleyecek AddingNew yöntemi temsil eder.

public delegate void AddingNewEventHandler(System::Object ^ sender, AddingNewEventArgs ^ e);

public delegate void AddingNewEventHandler(object? sender, AddingNewEventArgs e);

type AddingNewEventHandler = delegate of obj * AddingNewEventArgs -> unit

Public Delegate Sub AddingNewEventHandler(sender As Object, e As AddingNewEventArgs)

Parametreler

sender

Object

Olayın kaynağı, genellikle bir veri kapsayıcısı veya veriye bağlı koleksiyon.

e

AddingNewEventArgs

AddingNewEventArgs Olay verilerini içeren bir.

Örnekler

Aşağıdaki kod örneği, olayı işlemek BindingSource.AddingNew için temsilcinin AddingNewEventHandler nasıl kullanılacağını gösterir. Bu kod örneği, Nasıl yapılır: Windows Forms BindingSource ile Öğe Eklemeyi Özelleştirme bölümünde sağlanan daha büyük bir örneğin parçasıdır.

// This event handler provides custom item-creation behavior.
void OnCustomersBindingSourceAddingNew(Object^ sender, 
    AddingNewEventArgs^ e)
{
    e->NewObject = DemoCustomer::CreateNewCustomer();
}

// This event handler provides custom item-creation behavior.
void customersBindingSource_AddingNew(
    object sender, 
    AddingNewEventArgs e)
{
    e.NewObject = DemoCustomer.CreateNewCustomer();
}

' This event handler provides custom item-creation behavior.
 Private Sub customersBindingSource_AddingNew( _
 ByVal sender As Object, _
 ByVal e As AddingNewEventArgs) _
 Handles customersBindingSource.AddingNew

     e.NewObject = DemoCustomer.CreateNewCustomer()

 End Sub

Açıklamalar

Olay BindingSource.AddingNew , genellikle veri bağlama senaryolarında bir koleksiyona yeni öğe eklemeden önce gerçekleşir. Bu olayın işleyicisi, koleksiyon sınıfının standart eylemini geçersiz kılarak eklenecek yeni öğeyi sağlayabilir. Bu, parametresinin NewObjecte özelliği AddingNewEventArgs bu yeni öğeye ayarlanarak gerçekleştirilir. Genellikle bu öğe alıcı koleksiyonu tarafından beklenen türde olmalıdır, aksi takdirde koleksiyon türünde InvalidCastExceptionbir özel durum oluşturur.

Bu olay, ve System.ComponentModel.BindingList<T>gibi sınıflarda veri bağlama senaryolarında yaygın olarak System.Windows.Forms.BindingSource kullanılır.

Bir AddingNewEventHandler temsilci oluşturduğunuzda, olayı işleyecek yöntemi tanımlarsınız. Olayı olay işleyicinizle ilişkilendirmek için olaya temsilcinin bir örneğini ekleyin. Olay her gerçekleştiğinde, olay işleyici (siz temsilciyi kaldırmadığınız sürece) çağrılır. Olay işleyici temsilcileri hakkında daha fazla bilgi için bkz. Olayları İşleme ve Oluşturma.

Uzantı Metotları

GetMethodInfo(Delegate)

Belirtilen temsilci tarafından temsil edilen yöntemi temsil eden bir nesnesi alır.

Ayrıca bkz.

• AddingNewEventArgs
• BindingSource
• BindingList<T>