Gets or sets the script that is executed when the current document starts generating.

Namespace:  C1.C1Preview
Assembly:  C1.C1Report.2 (in C1.C1Report.2.dll)

Syntax

C#
[XmlAttributeAttribute("DocumentStartingScript")]
public string DocumentStartingScript { get; set; }
Visual Basic
<XmlAttributeAttribute("DocumentStartingScript")> _
Public Property DocumentStartingScript As String
	Get
	Set

Remarks

C1PrintDocument also fires the DocumentStarting event at this time.

The difference between events and scripts is that event handlers belong to the application code, while scripts belong to the document. Thus it is recommended that event handlers be used to perform tasks that implement the overall application logic but do not depend on the specific document being processed.

On the other hand, scripts should be used to perform tasks directly related to the document itself. Scripts attached to a document are executed regardless of the current application (e.g. when the document is regenerated after being loaded from file by a different program). (For example, a document might contain a script that changes the value of a field in that document when an error occurs.)

See Also