BindingSource.AddNew Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Adiciona um novo item à lista subjacente.

public:
 virtual System::Object ^ AddNew();

public virtual object AddNew ();

abstract member AddNew : unit -> obj
override this.AddNew : unit -> obj

Public Overridable Function AddNew () As Object

Retornos

Object

O Object que foi criado e adicionado à lista.

Implementações

AddNew()

Exceções

InvalidOperationException

A propriedade AllowNew é definida como false.

- ou -

Um construtor público sem parâmetros não pôde ser encontrado no tipo de item atual.

Exemplos

O exemplo de código a seguir usa um BindingSource componente para associar uma lista a um DataGridView controle. Novos itens são adicionados à lista pelo AddingNew manipulador de eventos. Este exemplo de código faz parte de um exemplo maior fornecido em Como personalizar a adição de item com o Windows Forms BindingSource.

private:
   
    void OnMainFormLoad(Object^ sender, EventArgs^ e)
    {
        // Add a DemoCustomer to cause a row to be displayed.
        this->customersBindingSource->AddNew();
          
        // Bind the BindingSource to the DataGridView 
        // control's DataSource.
        this->customersDataGridView->DataSource = 
            this->customersBindingSource;
    }

private void Form1_Load(System.Object sender, System.EventArgs e)
{
    // Add a DemoCustomer to cause a row to be displayed.
    this.customersBindingSource.AddNew();

    // Bind the BindingSource to the DataGridView 
    // control's DataSource.
    this.customersDataGridView.DataSource = 
        this.customersBindingSource;
}

Private Sub Form1_Load( _
ByVal sender As System.Object, _
ByVal e As System.EventArgs)

    ' Add a DemoCustomer to cause a row to be displayed.
    Me.customersBindingSource.AddNew()

    ' Bind the BindingSource to the DataGridView 
    ' control's DataSource.
    Me.customersDataGridView.DataSource = Me.customersBindingSource

End Sub

Comentários

O AddNew método adiciona um novo item à lista subjacente representada pela List propriedade . Esse método configura a seguinte série de ações:

1. O EndEdit método é chamado automaticamente para confirmar todas as operações de edição pendentes.

2. O AddingNew evento é gerado automaticamente. Esse evento pode ser tratado programaticamente para construir o novo item. Isso é feito no manipulador de eventos definindo a NewObject propriedade do System.ComponentModel.AddingNewEventArgs parâmetro como o novo item. O novo objeto criado no AddingNew evento deve ser do mesmo tipo que o tipo contido na lista ou ocorrerá uma exceção.

   Se o AddingNew evento não for tratado e a lista subjacente for um IBindingList, a solicitação será passada para o método da IBindingList.AddNew lista. Se a lista subjacente não for um IBindingList, o item será criado automaticamente por meio de seu construtor público sem parâmetros. Em ambos os casos, o novo item é adicionado ao final da lista.

3. O novo item é adicionado imediatamente à lista interna, a menos que a fonte de dados implemente a IEditableObject interface. Nesse caso, o novo item não é confirmado até que uma chamada explícita para ICancelAddNew.EndNew seja feita ou até que uma nova operação de lista seja iniciada. Antes de ser confirmado, o novo item pode ser revertido chamando CancelEdit, nesse caso, o novo item é descartado.

Esse método gera o ListChanged evento.

Confira também

• AddNew()
• AddingNewEventArgs
• AddingNew
• AllowNew
• IBindingList