DataGridView.RowErrorTextNeeded Událost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Nastane v případě, že je potřeba text chyby řádku.

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 

Event Type

DataGridViewRowErrorTextNeededEventHandler

Příklady

Následující příklad kódu ukazuje použití tohoto člena. V příkladu obslužná rutina události hlásí výskyt RowErrorTextNeeded události. Tato sestava vám pomůže zjistit, kdy k události dojde, a může vám pomoct s laděním. Pokud chcete hlásit více událostí nebo událostí, ke kterým dochází často, zvažte nahrazení MessageBox.ShowConsole.WriteLine nebo připojení zprávy k víceřádkovému TextBoxobjektu .

Pokud chcete spustit ukázkový kód, vložte ho do projektu, který obsahuje instanci typu DataGridView s názvem DataGridView1. Pak se ujistěte, že je obslužná rutina události přidružená k RowErrorTextNeeded události.

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

Poznámky

Událost RowErrorTextNeeded nastane pouze v DataSource případě, že je nastavena DataGridView vlastnost ovládacího prvku nebo je jeho VirtualMode vlastnost true. RowErrorTextNeeded Zpracování události je užitečné, když chcete určit chybu pro řádek v závislosti na jeho stavu a hodnotách, které obsahuje.

Při zpracování RowErrorTextNeeded události a zadání textu chyby v obslužné rutině se v záhlaví řádku zobrazí chybový glyf, pokud ShowRowErrors není vlastnost nastavena na false. Když uživatel přesune ukazatel myši na chybový glyf, zobrazí se text chyby v popisu.

Událost RowErrorTextNeeded také nastane při každém načtení hodnoty DataGridViewRow.ErrorText vlastnosti.

Vlastnost můžete použít DataGridViewRowErrorTextNeededEventArgs.RowIndex k určení stavu řádku nebo hodnot, které obsahuje, a použít tyto informace ke změně nebo úpravě DataGridViewRowErrorTextNeededEventArgs.ErrorText vlastnosti. Tato vlastnost je inicializována s hodnotou vlastnosti řádku ErrorText , kterou hodnota události přepíše.

RowErrorTextNeeded Zpracování události při práci s velkými objemy dat, abyste se vyhnuli výkonnostním sankcím při nastavování hodnoty řádku ErrorText pro více řádků. Další informace najdete v tématu Osvědčené postupy pro škálování ovládacího prvku model Windows Forms DataGridView.

Další informace o zpracování událostí najdete v tématu Zpracování a vyvolávání událostí.

Viz také

• DataSource
• VirtualMode
• ShowRowErrors
• DataGridViewRowErrorTextNeededEventHandler
• DataGridViewRowErrorTextNeededEventArgs
• ErrorText
• ErrorText
• OnRowErrorTextNeeded(DataGridViewRowErrorTextNeededEventArgs)
• DataGridView – ovládací prvek (Windows Forms)