SqlTrackingService.EnableRetries Property

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets and sets a value specifying whether the SqlTrackingService will retry when performing a database operation.

Namespace:   System.Workflow.Runtime.Tracking
Assembly:  System.Workflow.Runtime (in System.Workflow.Runtime.dll)

public bool EnableRetries { get; set; }

Property Value

Type: System.Boolean

true if the SqlTrackingService should retry the operation; otherwise, false.

If the IsTransactional property is set to false and EnableRetries is set to true, then all transaction retries depend on the value of the EnableRetries property.

If IsTransactional is set to true, then certain work is batched and retries of those work batch transactions are handled by a derived type of WorkflowCommitWorkBatchService, such as DefaultWorkflowCommitWorkBatchService or SharedConnectionWorkflowCommitWorkBatchService.

Regardless of whether IsTransactional is set to true, the following work items cannot be batched and any transaction retries must be handled through the EnableRetries property.

  • Polling for tracking profile changes.

  • All writes to a SQL Server database when IsTransactional is set to false.

Besides being set programmatically, this functionality can be enabled through a configuration file. For more information about how to set this property through a configuration file, see Workflow Configuration Files.

For general information about retrying work batch transactions, see Batching State Information in Workflows.

.NET Framework
Available since 3.0
Return to top
Show: