通过

DataGridView.RowErrorTextNeeded 事件

  • 参考

定义

命名空间:
System.Windows.Forms
程序集:
System.Windows.Forms.dll

在需要某一行的错误文本时发生。

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

事件类型

DataGridViewRowErrorTextNeededEventHandler

示例

下面的代码示例演示了此成员的用法。 在此示例中，事件处理程序报告事件的发生情况 RowErrorTextNeeded 。 此报表可帮助你了解事件发生的时间，并可以帮助你进行调试。 若要报告多个事件或频繁发生的事件，请考虑将 MessageBox.Show 替换为 Console.WriteLine 或将消息追加到多行 TextBox。

若要运行示例代码，请将其粘贴到包含名为 DataGridView1的 类型的DataGridView实例的项目中。 然后，确保事件处理程序与 RowErrorTextNeeded 事件相关联。

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

注解

RowErrorTextNeeded仅当设置了控件的 DataGridView 属性或其 VirtualMode 属性为 true时DataSource，才会发生该事件。 RowErrorTextNeeded如果要根据行的状态及其包含的值确定行的错误，处理事件非常有用。

处理 RowErrorTextNeeded 事件并在处理程序中指定错误文本时，除非 属性设置为 false，否则ShowRowErrors行标题中会显示错误字形。 当用户将鼠标指针移到错误字形上时，错误文本将显示在工具提示中。

RowErrorTextNeeded每当检索属性的值时，DataGridViewRow.ErrorText也会发生 该事件。

可以使用 DataGridViewRowErrorTextNeededEventArgs.RowIndex 属性来确定行的状态或其包含的值，并使用此信息更改或修改属性 DataGridViewRowErrorTextNeededEventArgs.ErrorText 。 此属性使用事件值替代的行 ErrorText 属性的值初始化。

RowErrorTextNeeded处理大量数据时处理 事件，以避免为多行设置行ErrorText值而造成性能损失。 有关详细信息，请参阅 缩放 Windows 窗体 DataGridView 控件的最佳做法。

有关如何处理事件的详细信息，请参阅 处理和引发事件。

适用于

另请参阅