SPSite.AddWorkItem Method (Guid, DateTime, Guid, Guid, Guid, Int32, Boolean, Guid, Guid, Int32, Byte , String, Guid, Boolean)
Adds a work item to the site collection.
Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Available in Sandboxed Solutions: No
Available in SharePoint Online
Syntax
'Declaration
<SubsetCallableExcludeMemberAttribute(SubsetCallableExcludeMemberType.PerSpec)> _
<PermissionSetAttribute(SecurityAction.LinkDemand, Name := "FullTrust")> _
<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _
Public Function AddWorkItem ( _
gWorkItemId As Guid, _
schdDateTime As DateTime, _
gWorkItemType As Guid, _
gWebId As Guid, _
gParentId As Guid, _
nItemId As Integer, _
fSetWebId As Boolean, _
gItemGuid As Guid, _
gBatchId As Guid, _
nUserId As Integer, _
rgbBinaryPayload As Byte(), _
strTextPayload As String, _
gProcessingId As Guid, _
useExponentialRetryBackOff As Boolean _
) As Guid
'Usage
Dim instance As SPSite
Dim gWorkItemId As Guid
Dim schdDateTime As DateTime
Dim gWorkItemType As Guid
Dim gWebId As Guid
Dim gParentId As Guid
Dim nItemId As Integer
Dim fSetWebId As Boolean
Dim gItemGuid As Guid
Dim gBatchId As Guid
Dim nUserId As Integer
Dim rgbBinaryPayload As Byte()
Dim strTextPayload As String
Dim gProcessingId As Guid
Dim useExponentialRetryBackOff As Boolean
Dim returnValue As Guid
returnValue = instance.AddWorkItem(gWorkItemId, _
schdDateTime, gWorkItemType, gWebId, _
gParentId, nItemId, fSetWebId, gItemGuid, _
gBatchId, nUserId, rgbBinaryPayload, _
strTextPayload, gProcessingId, useExponentialRetryBackOff)
[SubsetCallableExcludeMemberAttribute(SubsetCallableExcludeMemberType.PerSpec)]
[PermissionSetAttribute(SecurityAction.LinkDemand, Name = "FullTrust")]
[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")]
public Guid AddWorkItem(
Guid gWorkItemId,
DateTime schdDateTime,
Guid gWorkItemType,
Guid gWebId,
Guid gParentId,
int nItemId,
bool fSetWebId,
Guid gItemGuid,
Guid gBatchId,
int nUserId,
byte[] rgbBinaryPayload,
string strTextPayload,
Guid gProcessingId,
bool useExponentialRetryBackOff
)
Parameters
gWorkItemId
Type: System.GuidA GUID that identifies the work item.
schdDateTime
Type: System.DateTimeA System.DateTime object that represents the date and time at which the work item takes place.
gWorkItemType
Type: System.GuidA GUID that specifies the work item type.
gWebId
Type: System.GuidA GUID that specifies the Web site that is associated with the work item.
gParentId
Type: System.GuidA GUID that identifies the parent of the work item.
nItemId
Type: System.Int32A 32-bit integer that identifies a list item that is associated with the work item.
fSetWebId
Type: System.Booleantrue to set the Web identifier; otherwise, false.
gItemGuid
Type: System.GuidA GUID that specifies a list item that is associated with the work item.
gBatchId
Type: System.GuidA GUID that specifies a context identifier for the job work item engine. The value can vary depending on the job type; for example, for alerts it might store a user ID but for workflow it would store a workflow ID.
nUserId
Type: System.Int32A 32-bit integer index that identifies an SPUser object that represents the user who is responsible for scheduling the work item.
rgbBinaryPayload
Type: []A byte array that specifies a binary payload.
strTextPayload
Type: System.StringA string that specifies a text payload.
gProcessingId
Type: System.GuidA GUID that identifies the processing of the work item.
useExponentialRetryBackOff
Type: System.Booleantrue to use exponential back-off; otherwise, false.
Return Value
Type: System.Guid
A GUID that identifies the work item.
Remarks
The work item that is created through the AddWorkItem method is a schedule-job work item; its information can be accessed through the SPWorkItem class.