Refresh(RefreshRow,Boolean) Method

Refresh the display and/or refetch the data with or without events.

Syntax

Visual Basic

'Declaration
 
Public Overloads Sub Refresh( _
   ByVal action As RefreshRow, _
   ByVal refreshDescendantRows As Boolean _
) 

C#

public void Refresh( 
   RefreshRow action,
   bool refreshDescendantRows
)

Parameters

action

The refresh action to perform.

refreshDescendantRows

true to refresh all descendant rows recursively.

Remarks

Generally, painting a control is handled automatically while no events are occurring. However, there may be situations where you want the form or control updated immediately, for example, after some external event has caused a change to the form. In such a case, you would use the Refresh method.

The Refresh method can also be used to ensure that the user is viewing the latest copy of the data from the record source.

Example

Following code refreshes the first row in the UltraGrid and causes InitializeRow to be fired for it as well. Refresh method can be used to force the UltraGrid to repaint a row or fire InitializeRow event for the row.

Visual Basic

Imports Infragistics.Shared
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinGrid

  Private Sub Button74_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button74.Click

      ' Get the first visible row.
      Dim row As UltraGridRow = Me.UltraGrid1.Rows(0)

      ' Repaint the row.
      row.Refresh(RefreshRow.RefreshDisplay)

      ' Fire InitializeRow on the row.
      row.Refresh(RefreshRow.FireInitializeRow)

  End Sub

C#

using Infragistics.Shared;
using Infragistics.Win;
using Infragistics.Win.UltraWinGrid;
using System.Diagnostics;

private void button74_Click(object sender, System.EventArgs e)
{

	// Get the first visible row.
	UltraGridRow row = this.ultraGrid1.Rows[0];

	// Repaint the row.
	row.Refresh( RefreshRow.RefreshDisplay );

	// Fire InitializeRow on the row.
	row.Refresh( RefreshRow.FireInitializeRow );

}

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2