ReportDocument.OpenSubreport Method

Article
06/24/2008

Opens a subreport contained in the report and returns a ReportDocument object corresponding to the named subreport.

Namespace CrystalDecisions.CrystalReports.Engine Assembly CrystalDecisions.CrystalReports.Engine (CrystalDecisions.CrystalReports.Engine.dll)

Syntax

'Declaration
Public Overrideable Function OpenSubreport ( _
    ByVal subreportName As String _ 
) As CrystalDecisions.CrystalReports.Engine.ReportDocument

public virtual CrystalDecisions.CrystalReports.Engine.ReportDocument OpenSubreport (
    string subreportName
)

Parameters

subreportName

Return Value

Returns a separate ReportDocument that represents the subreport.

Remarks

Pass the value from the SubreportName Property of the SubreportObject as the subreportName parameter.

Treat the subreport as a report for the purposes of formatting, previewing, printing, and exporting.

Example

This example opens and previews a subreport.

'Declaration

      Private Sub OpenSubreport(ByVal reportObjectName As String)
         Dim subreportName As String
         Dim subreportObject As SubreportObject
         Dim subreport As New ReportDocument()

         If TypeOf (Report.ReportDefinition.ReportObjects. _
         Item(reportObjectName)) Is SubreportObject Then
            subreportObject = myReportDocument.ReportDefinition.ReportObjects. _
                Item(reportObjectName)
            subreportName = subreportObject.SubreportName
            subreport = myReportDocument.OpenSubreport(subreportName)
            MyCrystalReportViewer.ReportSource = subreport
         End If
      End Sub

      private void OpenSubreport(string reportObjectName)
      {
         string subreportName;
         SubreportObject subreportObject;
         ReportDocument subreport = new ReportDocument();

         subreportObject = reportDocument.ReportDefinition.ReportObjects
         [reportObjectName] as SubreportObject;
         if (subreportObject != null)
         {
            subreportName = subreportObject.SubreportName;
            subreport = reportDocument.OpenSubreport(subreportName);
            crystalReportViewer.ReportSource = subreport;
         }
      }

Version Information

Crystal Reports Basic for Visual Studio 2008

Supported since: Crystal Reports for Visual Studio .NET 2002

Share via