ASPxGridViewBehaviorSettings.ProcessFocusedRowChangedOnServer Property

Gets or sets a value that specifies whether a change to the focused row should be completely processed on the server side.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v18.2.dll

Declaration

C#

[DefaultValue(false)]
public bool ProcessFocusedRowChangedOnServer { get; set; }

VB.NET

<DefaultValue(False)>
Public Property ProcessFocusedRowChangedOnServer As Boolean

Property Value

Type	Default	Description
Boolean	**false**	true to completely process focused row changes on the server side; false to have the ability to handle it on the client side.

Property Paths

You can access this nested property as listed below:

Library	Object Type	Path to ProcessFocusedRowChangedOnServer
ASP.NET Bootstrap Controls	BootstrapGridView	.SettingsBehavior.ProcessFocusedRowChangedOnServer
ASP.NET Web Forms Controls	ASPxGridView	.SettingsBehavior.ProcessFocusedRowChangedOnServer
	GridViewProperties	.SettingsBehavior.ProcessFocusedRowChangedOnServer
	GridViewSettings	.SettingsBehavior.ProcessFocusedRowChangedOnServer
	GridViewSettings<RowType>	.SettingsBehavior.ProcessFocusedRowChangedOnServer
	MVCxGridView	.SettingsBehavior.ProcessFocusedRowChangedOnServer
	MVCxGridViewProperties	.SettingsBehavior.ProcessFocusedRowChangedOnServer

Remarks

If the ProcessFocusedRowChangedOnServer property is set to false (the default behavior), the ASPxClientGridView.FocusedRowChanged client event is always fired in response to moving row focus, and no postback to the server occurs. This allows you to completely handle a focused row change on the client side. If you need to finally process the event on the server side, you can set the event argument’s ASPxClientProcessingModeEventArgs.processOnServer property to true in an event handler. This initiates a round trip to the server and generates the corresponding ASPxGridView.FocusedRowChanged server-side event, which if handled, allows any desired server-side action to be performed. Note that a peculiarity of the ProcessFocusedRowChangedOnServer property set to false is that the ASPxGridView.FocusedRowChanged server event is initially fired on the server during the first grid control initialization (when the ASPxGridView.FocusedRowIndex property is set from -1 to a real value).

Setting the ProcessFocusedRowChangedOnServer property to true indicates that all processing of focused row changes should be performed on the server side, using the ASPxGridView.FocusedRowChanged server event, so a round trip to the server is always required. In this case, the ASPxClientGridView.FocusedRowChanged client event is not called on each change of the focused row. A peculiarity here is that the ASPxClientGridView.FocusedRowChanged client event is generated only one time - on the first initialization of the client grid object.

CodeCentral Examples

• How to display master-detail tables in two grids on separate tabs of a PageControl
• How to force the grid to stay in Edit mode

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the ProcessFocusedRowChangedOnServer property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-reload-grid-data-when-navigating-the-treelist-e934/CS/SyncWithGridOnUpdatePanel/Default.aspx.cs#L39

ASPxGridView1.SettingsBehavior.AllowFocusedRow = true;
ASPxGridView1.SettingsBehavior.ProcessFocusedRowChangedOnServer = true;
if(!IsPostBack && !IsCallback)

VB.NET

how-to-reload-grid-data-when-navigating-the-treelist-e934/VB/SyncWithGridOnUpdatePanel/Default.aspx.vb#L41

ASPxGridView1.SettingsBehavior.AllowFocusedRow = True
ASPxGridView1.SettingsBehavior.ProcessFocusedRowChangedOnServer = True
If (Not IsPostBack) AndAlso (Not IsCallback) Then