AddingNewEventHandler Temsilci

Tanım

Ad Alanı:

System.ComponentModel

Bütünleştirilmiş Kodlar:

netstandard.dll, System.ComponentModel.TypeConverter.dll

Kaynak:

AddingNewEventHandler.cs

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 bir öğ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 bu yeni öğeye AddingNewEventArgs 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 işleyicisi, temsilciyi kaldırmadığınız sürece olay gerçekleştiğinde çağrılır. Olay işleyicisi temsilcileri hakkında daha fazla bilgi için bkz. Olayları İşleme ve Oluşturma.

Uzantı Metotları

Name	Description
GetMethodInfo(Delegate)	Belirtilen temsilci tarafından temsil edilen yöntemi temsil eden bir nesnesi alır.

Ayrıca bkz.

• AddingNewEventArgs
• BindingSource
• BindingList<T>