SqlTrackingQueryOptions.TrackingDataItems Property

Definition

Namespace:

System.Workflow.Runtime.Tracking

Assembly:

System.Workflow.Runtime.dll

Gets or sets a list of data extract values which are used to constrain the set of SqlTrackingWorkflowInstance objects returned by a call to GetWorkflows(SqlTrackingQueryOptions).

public:
 property System::Collections::Generic::IList<System::Workflow::Runtime::Tracking::TrackingDataItemValue ^> ^ TrackingDataItems { System::Collections::Generic::IList<System::Workflow::Runtime::Tracking::TrackingDataItemValue ^> ^ get(); };

public System.Collections.Generic.IList<System.Workflow.Runtime.Tracking.TrackingDataItemValue> TrackingDataItems { get; }

member this.TrackingDataItems : System.Collections.Generic.IList<System.Workflow.Runtime.Tracking.TrackingDataItemValue>

Public ReadOnly Property TrackingDataItems As IList(Of TrackingDataItemValue)

Property Value

IList<TrackingDataItemValue>

A List<T> of TrackingDataItemValue objects that contains specified values to be matched for data extracted from the workflow instance or a null reference (Nothing in Visual Basic).

Remarks

SqlTrackingQueryOptions constrains the set of SqlTrackingWorkflowInstance objects returned by a call to SqlTrackingQuery.GetWorkflows to those workflow instances that have the Type specified by WorkflowType, that have the status specified by WorkflowStatus during the period specified by StatusMinDateTime and StatusMaxDateTime, and that have extracted data that matches at least one of the TrackingDataItemValue objects specified by TrackingDataItems.

ActivityTrackingRecord.Body or UserTrackingRecord.Body can contain TrackingDataItem records that contain data that is extracted from the workflow. The TrackingDataItems property contains TrackingDataItemValue objects that specify certain values for this extracted data. If the workflow instance meets the other criteria specified by SqlTrackingQueryOptions and TrackingDataItems is not a null reference (Nothing), the extracted data stored in the database for a workflow instance must match one or more of the extracted data values specified by the TrackingDataItems property for a SqlTrackingWorkflowInstance object to be returned for the workflow instance.

If TrackingDataItems is a null reference (Nothing), the set of SqlTrackingWorkflowInstance objects returned will not be constrained by the values of the extracted data for any of the workflow instances in the database.