Script Property

Sets or returns the script code for a report's events. Either this property or the script editor may be used to add script to a report.

[Visual Basic]
Public Property Script As String

[C#]
public string Script {get; set;}

Return Type

The current script code. The default value is an empty string.

Remarks

The Script property can be used to make modifications to the report outside the code written in the report's events. The script events run immediately after their matching ActiveReports code-behind events and take precedence over the code inside the project.

If reports with scripts are saved to XML, the scripts (unlike code-behind) are incorporated into the XML file. Changes can be made to the XML file scripts and then loaded back into a report project to show the changes. This allows reports to be modified without requiring the project to be recompiled.

When referencing the report in the script, use rpt instead of the report's name or "Me" or "this".

In order to reference a member of the report class using the "rpt" named object, the member has to be a public member. You can use a control's modifier property to change the generated code for a control from private to public.

If you plan to run the report from a stand-alone RPX file without the compiled code-behind class, your scripting code would have to reference the report class controls using the Controls collection instead of by name.

Scripts are compiled at run time using the language specified in the ScriptLanguage property.

Example

This snippet assumes that you have html in the RichTextBox, and that the Modifiers property of the RichTextBox is set to Public.

[C#]

Private void btnScript_Click(object sender, System.EventArgs e) 
{ 
    string sScript = string.Empty; 
    rptDataDynamics rpt = New rptDataDynamics(); 
 
    sScript += "public void ReportHeader_Format()"; 
    sScript += "{"; 
    sScript += "rpt.RichTextBox1.Html = rpt.RichTextBox1.Text;"; 
    sScript += "}"; 
 
    rpt.Script = rpt.Script + "\n" + sScript; 
    rpt.Run(); 
    arv.Document = rpt.Document; 
}

[Visual Basic]

Private Sub btnScript_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles btnScript.Click

    Dim sScript As String = String.Empty

    Dim rpt As New rptDD



    sScript = "public void ReportHeader_Format()"

    sScript = sScript + "{"

    sScript = sScript + "rpt.RichTextBox1.Html = rpt.RichTextBox1.Text;"

    sScript = sScript + "}"



    rpt.Script = sScript

    rpt.Run()

    Viewer1.Document = rpt.Document

End Sub

See Also

Language

Script Property

Return Type

Remarks

Example

See Also