clientapi-grid-context.md

title	description	author	ms.author	ms.date	ms.reviewer	ms.topic	ms.subservice	search.audienceType	contributors
Client API grid context in model-driven apps| MicrosoftDocs	Describes the client API grid context	fikaradz	fikaradz	08/15/2024	jdaly	conceptual	mda-developer	developer	JimDaly caburk fikaradz tahoon-ms

Client API grid context

Grids present data in a tabular format. Grids can span the entire form or can be one of the items on a form; the latter are called subgrids.

The Client API grid context object provides reference to a subgrid on a form against which the current code is executed.

Use the formContext object to get an instance of the form where the code is executed, and then retrieve the subgrid control on the form. For example, when you know the name of a subgrid control (say Contacts subgrid in the default account form), you can access it using the following code:

function doSomething(executionContext) {
   var formContext = executionContext.getFormContext(); // get the form Context
   var gridContext = formContext.getControl("Contacts"); // get the grid context

   // Perform operations on the subgrid
}

Limitations

• Getting the context of a grid (spanning the entire form) is only supported in ribbon commands. More information: Form and grid context in ribbon actions
• Calls to getControl() aren't supported when you use gridContext.
• Grid contexts have the same validity as their execution context. Once the event handler for the execution context finishes, these contexts require extra care to use. See Using context objects asynchronously

Related articles

Client API form context
Client API execution context
Understand the Client API object model
Grids and subgrids

[!INCLUDEfooter-include]