Cancel Method

Cancels the report's processing. Any rendered pages will be cleared from the report's Document object.

Syntax

Visual Basic
C#

'Declaration
 
Public Sub Cancel()

public void Cancel()

Remarks

You can call this method based on a user's request or in a report event such as ReportStart to prevent printing a blank report if their data source did not return any records.

Example

private void rptDataDynamics_ReportStart(object sender, System.EventArgs eArgs)
{
    if (this.DataSource==null)
    {
        this.Cancel();
    }
}

Visual Basic

Private Sub rptDD_ReportStart(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyBase.ReportStart
    If Me.DataSource Is Nothing Then
        Me.Cancel()
    End If
End Sub

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

ActiveReport Class
ActiveReport Members
Stop Method