BindingSource.AddNew Método

Definição

Espaço de Nomes:
System.Windows.Forms
Assemblagem:
System.Windows.Forms.dll
Origem:
BindingSource.cs
Origem:
BindingSource.cs
Origem:
BindingSource.cs
Origem:
BindingSource.cs
Origem:
BindingSource.cs

Adiciona um novo item à lista subjacente.

public:
 virtual System::Object ^ AddNew();
public virtual object AddNew();
public virtual object? AddNew();
abstract member AddNew : unit -> obj
override this.AddNew : unit -> obj
Public Overridable Function AddNew () As Object

Devoluções

Object

Isso Object foi criado e adicionado à lista.

Implementações

AddNew()

Exceções

InvalidOperationException

A propriedade AllowNew está definida como false.

-ou-

Não foi possível encontrar um construtor público sem parâmetros para o tipo de item atual.

Exemplos

O exemplo de código seguinte utiliza um BindingSource componente para associar uma lista a um DataGridView controlo. Novos itens são adicionados à lista pelo AddingNew gestor de eventos. Este exemplo de código faz parte de um exemplo maior fornecido em How to: Customize Item Addition with the 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

Observações

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

  1. O EndEdit método é automaticamente chamado para comprometer quaisquer operações de edição pendentes.

  2. O AddingNew evento é automaticamente elevado. Este evento pode ser gerido programaticamente para construir o novo item. Isto é conseguido no gestor de eventos ao definir a NewObject propriedade do System.ComponentModel.AddingNewEventArgs parâmetro para o novo item. O novo objeto criado no AddingNew evento deve ser do mesmo tipo do tipo contido na lista, caso contrário ocorrerá uma exceção.

    Se o AddingNew evento não for tratado, e a lista subjacente for um IBindingList, então o pedido é passado para o método da IBindingList.AddNew lista. Se a lista subjacente não for um IBindingList, o item é automaticamente criado através do seu construtor público sem parámetros. Em qualquer dos 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. Neste caso, o novo item não é comprometido até que seja feita uma chamada explícita para ICancelAddNew.EndNew ou até que uma nova operação de lista seja iniciada. Antes de ser comprometido, o novo item pode ser revertido ao chamar CancelEdit, caso em que o novo item é descartado.

Este método eleva o ListChanged evento.

Aplica-se a

Ver também