IPublishingTargetRepublishPage Method

Performs publish on a Page, or the page and its descendants, towards this publishing target.

For a non-Transform-on-publish target, this action creates XML files for pages and components marked for this target; generates all metadata files needed for the Dynamic Site Server; and copies over all updated assets.

For a Transform-on-publish target, Pages will be fully expanded and XSLT transformed, then saved to target folder in a structured format. Updated assets are also copied over.

Namespace: Ingeniux.CMS
Assembly: Ingeniux.CMS.CSAPI (in Ingeniux.CMS.CSAPI.dll) Version: 10.6.492

Syntax

C++

Copy

void RepublishPage(
	IPage page,
	bool recursive = true,
	bool incremental = true,
	bool replicate = true,
	IEnumerable<IDependencyNode> selectedDependencies = null
)

Sub RepublishPage ( 
	page As IPage,
	Optional recursive As Boolean = true,
	Optional incremental As Boolean = true,
	Optional replicate As Boolean = true,
	Optional selectedDependencies As IEnumerable(Of IDependencyNode) = Nothing
)

void RepublishPage(
	IPage^ page, 
	bool recursive = true, 
	bool incremental = true, 
	bool replicate = true, 
	IEnumerable<IDependencyNode^>^ selectedDependencies = nullptr
)

abstract RepublishPage : 
        page : IPage * 
        ?recursive : bool * 
        ?incremental : bool * 
        ?replicate : bool * 
        ?selectedDependencies : IEnumerable<IDependencyNode> 
(* Defaults:
        let _recursive = defaultArg recursive true
        let _incremental = defaultArg incremental true
        let _replicate = defaultArg replicate true
        let _selectedDependencies = defaultArg selectedDependencies null
*)
-> unit

Parameters

page IPage: The root Page to be published
recursive Boolean (Optional): Whether to only publish the Page itself, or with with its descendants.
incremental Boolean (Optional): Whether to only publish changed Pages or all pages. Default is incremental.
replicate Boolean (Optional): Whether to perform replication after a successful publish. Default is to replicate.
selectedDependencies IEnumerableIDependencyNode (Optional): [Missing <param name="selectedDependencies"/> documentation for "M:Ingeniux.CMS.IPublishingTarget.RepublishPage(Ingeniux.CMS.IPage,System.Boolean,System.Boolean,System.Boolean,System.Collections.Generic.IEnumerable{Ingeniux.CMS.IDependencyNode})"]

Exceptions

Exception	Condition
InvalidOperationException	When this Publishing Target is retrieved via a Read-only Session.
SecurityException	When current user doesn't have the permission to perform a publish; when the current user can't access this publishing target; or when performing an incremental publish and the current user doesn't have the permissions to incrementally publish.
XmlException	When any XSLT style sheet failed to load as an XML document.

Remarks

This method is in charge of handling the task that carries out the actual publishes. It will not wait for the publish to finish.

All publish tasks are pushed into a queue and executed in sequence.

Incremental publishes will detect if any pages were changed (checked in, marked for publish changes, etc.) since the last publish. If no pages are changed since the last publish, an error is thrown.

Full publishes first clean up the target folder by deleting all files and directories.

If current user doesn't have access right to use this publishing target, the publish will not happen and an error log entry will be written to design-time log.

All XSLT style sheets in the "xml/Stylesheets" folder are validated during publish.

The event BeforePublish is fired prior to creating a Publishing Task.

The event BeforePublish is fired after a Publishing Task completes the actual publish, not after the Publishing Task is created.

Reference

IPublishingTarget Interface

Ingeniux.CMS Namespace