Edit

Share via


SqlTrackingService.EnableRetries Property

Definition

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

public:
 property bool EnableRetries { bool get(); void set(bool value); };
public bool EnableRetries { get; set; }
member this.EnableRetries : bool with get, set
Public Property EnableRetries As Boolean

Property Value

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

Remarks

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.

Applies to