SubreportObject.OpenSubreport Method

The OpenSubreport method 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
    Indicates the name of the subreport to open.

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 = Report.ReportDefinition.ReportObjects. _
               Item(reportObjectName)
            subreportName = subreportObject.SubreportName
            subreport = subreportObject.OpenSubreport(subreportName)
            MyCrystalReportViewer.ReportSource = subreport
         End If
      End Sub
      
      private void OpenSubreport(string reportObjectName)
      {
         string subreportName;
         SubreportObject subreportObject;
         ReportDocument subreport = new ReportDocument();

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

Version Information

Crystal Reports Basic for Visual Studio 2008

Supported since: Crystal Reports for Visual Studio .NET 2002

See Also

Reference

SubreportObject Class
SubreportObject Members
CrystalDecisions.CrystalReports.Engine Namespace