AddingNewEventArgs Classe

Definição

Namespace:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Origem:

AddingNewEventArgs.cs

Fornece dados para o evento de AddingNew .

public ref class AddingNewEventArgs : EventArgs

public class AddingNewEventArgs : EventArgs

type AddingNewEventArgs = class
    inherit EventArgs

Public Class AddingNewEventArgs
Inherits EventArgs

Herança

Object

EventArgs

AddingNewEventArgs

Exemplos

O exemplo de código a seguir demonstra como usar a AddingNewEventArgs classe para manipular o BindingSource.AddingNew evento. Este exemplo de código faz parte de um exemplo maior fornecido em Como personalizar a adição de itens com o Windows Forms BindingSource.

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

Comentários

A AddingNewEventArgs classe fornece dados para o BindingSource.AddingNew evento , que sinaliza que um item está prestes a ser adicionado a uma coleção. O evento fornece ao programador, dentro do manipulador AddingNewEventHandlerde eventos , a opção de fornecer o novo objeto definindo a NewObject propriedade para esse novo item. Se essa propriedade não estiver definida, a coleção normalmente usará o construtor sem parâmetros do tipo apropriado para construir um novo item. Em ambos os casos, o novo item será adicionado à coleção.

Se a coleção também implementar a ICancelAddNew interface , o item será adicionado provisoriamente, aguardando uma confirmação ou reversão subsequente.

Esse evento é comumente usado em cenários de associação de dados, dentro de classes como System.Windows.Forms.BindingSource e System.ComponentModel.BindingList<T>.

Para obter mais informações sobre como lidar com eventos, consulte Manipulando e gerando eventos.

Construtores

AddingNewEventArgs()	Inicializa uma nova instância da classe AddingNewEventArgs não usando nenhum parâmetro.
AddingNewEventArgs(Object)	Inicializa uma nova instância da classe AddingNewEventArgs usando o objeto especificado como o novo item.

Propriedades

NewObject

Obtém ou define o objeto a ser adicionado à lista de associação.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• AddingNewEventHandler
• AddingNew
• ICancelAddNew