Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.

Tradução

Original

Este tópico ainda não foi avaliado como - Avalie este tópico

Delegado DataGridViewRowErrorTextNeededEventHandler

.NET Framework 4.5

Outras versões

Representa o método que manipulará o RowErrorTextNeeded o evento de um DataGridView.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (em System.Windows.Forms.dll)

Sintaxe

C++

public delegate void DataGridViewRowErrorTextNeededEventHandler(
	Object sender,
	DataGridViewRowErrorTextNeededEventArgs e
)

Parâmetros

sender: Tipo: System.Object
A origem do evento.

e: Tipo: System.Windows.Forms.DataGridViewRowErrorTextNeededEventArgs
A DataGridViewRowErrorTextNeededEventArgs que contém os dados do evento.

Comentários

O RowErrorTextNeeded evento ocorre somente quando o DataGridView controle DataSource propriedade é definida ou seu VirtualMode propriedade é true. Manipulando o RowErrorTextNeeded evento é útil quando você deseja determinar o erro para uma linha, dependendo do seu estado e os valores que ele contém.

Quando você lida com o RowErrorTextNeeded eventos e especificar o texto de erro no manipulador, um glifo de erro aparece no cabeçalho da linha, a menos que o DataGridView.ShowRowErrors propriedade estiver definida como false. Quando o usuário move o ponteiro do mouse sobre o glifo de erro, o texto de erro aparece em uma dica de ferramenta.

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

Você pode usar o DataGridViewRowErrorTextNeededEventArgs.RowIndex propriedade para determinar o estado ou valor de uma linha e, em seguida, usar essas informações para alterar ou modificar o DataGridViewRowErrorTextNeededEventArgs.ErrorText propriedade. Essa propriedade é inicializada com o valor da linha ErrorText propriedade, que substitui ao valor do evento.

Lidar com o RowErrorTextNeeded o evento ao trabalhar com grandes quantidades de dados para evitar as penalidades de desempenho de definir a linha ErrorText valor para várias linhas. Para obter mais informações, consulte Práticas recomendadas para escala o controle DataGridView do Windows Forms.

Para obter mais informações sobre tratamento de eventos, consulte Consumindo Eventos.

Quando você cria um DataGridViewRowErrorTextNeededEventHandler representante, você identifica o método que manipulará o evento. Para associar o evento com o manipulador de eventos, adicione uma instância do delegate ao evento. O manipulador de evento é chamado sempre que o evento ocorre, a menos que você remova o delegate. Para obter mais informações sobre delegates de manipulador de eventos, consulte Eventos e representantes.

Informações sobre versão

.NET Framework

Com suporte em: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Plataformas

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte .Requisitos de sistema do NET Framework.

Consulte também