DataGridView.DefaultValuesNeeded Evento
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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;public event System.Windows.Forms.DataGridViewRowEventHandler? DefaultValuesNeeded;member this.DefaultValuesNeeded : System.Windows.Forms.DataGridViewRowEventHandler Public Custom Event DefaultValuesNeeded As DataGridViewRowEventHandler Tipo de evento
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.
