IExecutionContext.Depth Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets the current depth of execution in the call stack.
public:
property int Depth { int get(); };public int Depth { get; }member this.Depth : intPublic ReadOnly Property Depth As IntegerProperty Value
T the current depth of execution in the call stack.
Remarks
Used by the platform for infinite loop prevention. In most cases, this property can be ignored.
Do not take any dependency on the IExecutionContext.Depth property in your code. Depth is used solely to manage potential infinite loops that could occur in plug-in or custom workflow activities. Any business logic that depends on a specific Depth value will break when the operation is performed in a different code path that may occur at any time because of configuration changes outside of your control.
Every time a running plug-in or Workflow issues a message request to the Web services that triggers another plug-in or Workflow to execute, the Depth property of the execution context is increased. If the depth property increments to its maximum value within the configured time limit, the platform considers this behavior an infinite loop and further plug-in or Workflow execution is aborted.
The maximum depth (8) and time limit (one hour) are configurable by the Microsoft Dynamics 365 administrator using the PowerShell command Set-CrmSetting. The setting is WorkflowSettings.MaxDepth. For more information, see, “Administer the deployment using Windows PowerShell” in the Deploying and administering Microsoft Dynamics CRM.