DataGridView.DefaultValuesNeeded Evento

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ocorre quanto o usuário entra na linha para novos registros, de modo que seja possível preenchê-la com valores padrão.

public:
 event System::Windows::Forms::DataGridViewRowEventHandler ^ DefaultValuesNeeded;

public event System.Windows.Forms.DataGridViewRowEventHandler DefaultValuesNeeded;

member this.DefaultValuesNeeded : System.Windows.Forms.DataGridViewRowEventHandler 

Public Custom Event DefaultValuesNeeded As DataGridViewRowEventHandler 

Tipo de evento

DataGridViewRowEventHandler

Exemplos

O exemplo de código a seguir ilustra como esse evento pode ser tratado. No exemplo, as células das colunas fornecidas são preenchidas com valores padrão. Para a CustomerID coluna, o valor é recuperado de um método separado (não implementado) que gera uma ID de cliente exclusiva.

Para executar este exemplo, substitua os nomes de coluna pelos nomes dos objetos de coluna de um controle real DataGridView e forneça valores padrão apropriados. Ao especificar colunas por nome, você deve usar o nome do objeto de coluna e não o texto do cabeçalho da coluna.

private void dataGridView1_DefaultValuesNeeded(object sender,
    System.Windows.Forms.DataGridViewRowEventArgs e)
{
    e.Row.Cells["Region"].Value = "WA";
    e.Row.Cells["City"].Value = "Redmond";
    e.Row.Cells["PostalCode"].Value = "98052-6399";
    e.Row.Cells["Country"].Value = "USA";
    e.Row.Cells["CustomerID"].Value = NewCustomerId();
}

Private Sub dataGridView1_DefaultValuesNeeded(ByVal sender As Object, _
    ByVal e As System.Windows.Forms.DataGridViewRowEventArgs) _
    Handles dataGridView1.DefaultValuesNeeded

    With e.Row
        .Cells("Region").Value = "WA"
        .Cells("City").Value = "Redmond"
        .Cells("PostalCode").Value = "98052-6399"
        .Cells("Country").Value = "USA"
        .Cells("CustomerID").Value = NewCustomerId()
    End With

End Sub

Comentários

Esse evento permite que você preencha a linha para novos registros quando o usuário entra na linha. Os valores iniciais da linha vêm da DefaultNewRowValue propriedade do DataGridViewCell retornado pela propriedade de CellTemplate cada coluna.

No modo associado a dados, todos os valores de célula para colunas associadas a dados são armazenados na fonte de dados externa. Quando o usuário insere a linha para novos registros, uma nova linha é criada na fonte de dados antes que o DefaultValuesNeeded evento ocorra. Quando você preenche a DataGridViewRowEventArgs.Row propriedade no manipulador de eventos, os valores são adicionados diretamente à fonte de dados.

No modo virtual, depois que esse evento ocorre, o CellValuePushed evento ocorre para cada célula na nova linha para que você possa armazenar os valores padrão no armazenamento de dados personalizado. Em seguida, o CellValueNeeded evento ocorre para cada célula na nova linha, recuperando os valores armazenados no CellValuePushed evento, que são exibidos em seguida.

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

Confira também

• Controle DataGridView (Windows Forms)