Creates a new publishing task and pushes this task into publishing queue.
Tasks in the queue are executed in sequence and purged after being executed.
Namespace: Ingeniux.CMS
Assembly: Ingeniux.CMS.CSAPI (in Ingeniux.CMS.CSAPI.dll) Version: 9.0.565.0 (9.0.565)
Syntax
IPublishingTask CreateTask( IEnumerable<IPublishingPageEntry> pages, bool incremental, IPublishingTarget pubTarget, Action<IEnumerable<IPublishingPageEntry>> postPageFilterCallback, bool replicate = true )
Parameters
- pages
- Type: System.Collections.GenericIEnumerableIPublishingPageEntry
Collection of pages to be published - incremental
- Type: SystemBoolean
Incremental or full publish. Incremental publishes only add or update pages and components that have been added or changed. Full publishes publish all marked pages and components; delete pages and components that are no longer marked; and clean up assets at the publishing target location. - pubTarget
- Type: Ingeniux.CMSIPublishingTarget
The target to publish pages to - postPageFilterCallback
- Type: SystemActionIEnumerableIPublishingPageEntry
The action to call after filter out the Pages that don't need to be published - replicate (Optional)
- Type: SystemBoolean
Whether or not to perform replication after the publish completes. Default is to perform replication.
Return Value
Type: IPublishingTaskThe created and queue publishing task
Exceptions
Exception | Condition |
---|---|
InvalidOperationException | During an incremental publish, when there are no pages or components that have been added or updated since the most-recent publish. |
Remarks
Publish Tasks are centered around pages and components, not assets, for incremental publishes.
If no pages or components changed since last publish, it doesn't matter whether any assets are changed. The publish will not occur.
See Also