DataGridView.RowErrorTextNeeded Evento

Definição

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

Ocorre quando o texto de erro de uma linha é necessário.

public:
 event System::Windows::Forms::DataGridViewRowErrorTextNeededEventHandler ^ RowErrorTextNeeded;
public event System.Windows.Forms.DataGridViewRowErrorTextNeededEventHandler RowErrorTextNeeded;
public event System.Windows.Forms.DataGridViewRowErrorTextNeededEventHandler? RowErrorTextNeeded;
member this.RowErrorTextNeeded : System.Windows.Forms.DataGridViewRowErrorTextNeededEventHandler 
Public Custom Event RowErrorTextNeeded As DataGridViewRowErrorTextNeededEventHandler

Tipo de Evento

DataGridViewRowErrorTextNeededEventHandler

Exemplos

O seguinte exemplo de código demonstra a utilização deste elemento. No exemplo, um gestor de eventos reporta a ocorrência do RowErrorTextNeeded evento. Este relatório ajuda-o a saber quando o evento ocorre e pode ajudá-lo na depuração. Para reportar múltiplos eventos ou eventos que ocorrem frequentemente, considere substituir MessageBox.Show ou Console.WriteLine anexar a mensagem a uma multilinha TextBox.

Para executar o código de exemplo, cole-o num projeto que contenha uma instância do tipo DataGridView chamada DataGridView1. Depois, certifique-se de que o gestor de eventos está associado ao RowErrorTextNeeded evento.

private void DataGridView1_RowErrorTextNeeded(Object sender, DataGridViewRowErrorTextNeededEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "ErrorText", e.ErrorText );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "RowIndex", e.RowIndex );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "RowErrorTextNeeded Event" );
}

Private Sub DataGridView1_RowErrorTextNeeded(sender as Object, e as DataGridViewRowErrorTextNeededEventArgs) _ 
     Handles DataGridView1.RowErrorTextNeeded

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "ErrorText", e.ErrorText)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "RowIndex", e.RowIndex)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"RowErrorTextNeeded Event")

End Sub

Observações

O RowErrorTextNeeded evento ocorre apenas quando a DataSource propriedade do DataGridView controlo é definida ou a sua VirtualMode propriedade é true. Gerir o RowErrorTextNeeded evento é útil quando se quer determinar o erro de uma linha dependendo do seu estado e dos valores que contém.

Quando se trata do RowErrorTextNeeded evento e se especifica o texto de erro no handler, aparece um glifo de erro no cabeçalho da linha, a menos que a ShowRowErrors propriedade esteja definida para false. Quando o utilizador move o ponteiro do rato sobre o glifo de erro, o texto do erro aparece numa ToolTip.

O RowErrorTextNeeded evento também ocorre sempre que o valor da DataGridViewRow.ErrorText propriedade é recuperado.

Pode usar a DataGridViewRowErrorTextNeededEventArgs.RowIndex propriedade para determinar o estado de uma linha ou os valores que ela contém, e usar esta informação para alterar ou modificar a DataGridViewRowErrorTextNeededEventArgs.ErrorText propriedade. Esta propriedade é inicializada com o valor da propriedade linha ErrorText , que o valor do evento sobrepõe.

Trate do RowErrorTextNeeded evento ao trabalhar com grandes quantidades de dados para evitar as penalizações de desempenho de definir o valor da linha ErrorText para várias linhas. Para mais informações, consulte Boas Práticas para Escalar o Controlo Windows Forms DataGridView.

Para mais informações sobre como gerir eventos, consulte Gestão e Levantamento de Eventos.

Aplica-se a

Ver também