SPWorkflowTask.AlterTask Method

Updates the specified task with the specified property values.

Namespace:  Microsoft.SharePoint.Workflow
Assembly:  Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Available in Sandboxed Solutions: Yes
Available in SharePoint Online

public static bool AlterTask(
	SPListItem task,
	Hashtable htData,
	bool fSynchronous


Type: Microsoft.SharePoint.SPListItem

The workflow task to be updated.

Type: System.Collections.Hashtable

A hash table with name-value pairs that correspond to field names and new values.

Type: System.Boolean

true to wait up to 30 seconds for the outcome of the attempted update; otherwise false.

Return Value

Type: System.Boolean
If true is passed as the argument to fSynchronous, this method waits up to 30 seconds to determine whether the attempted update was accepted by the workflow schedule as valid. The method then returns true if the update was accepted and not rolled back, or false if the update was not accepted. If false is passed as the argument to fSynchronous, this method always returns true.


The argument to the task parameter is a null reference (Nothing in Visual Basic).


The content type of the item passed to the task parameter is not derived from the WorkflowTask content type.

This method cannot be used to modify read-only properties of a task.