Share via


CrystalReportViewer Binding Scenarios that Use Crystal Services

Using Crystal Services in Visual Studio

Crystal Reports for Visual Studio allows programmatic access to Server Files via Crystal Services.

Using Crystal Services in Visual Studio 2003 and earlier

In Visual Studio 2002 and 2003 you can access Crystal reports through the Crystal Services node in the Server Explorer. When Crystal Reports and Crystal Services are both installed, Crystal Services appears as a sub node within each server listed in the Server Explorer.

The Crystal Services node expands to display lists of reports from various locations:

  • The local file directory on your hard drive.
  • Report Application Server (RAS)
  • Crystal Enterprise (CE)

You can drag and drop any report from these lists onto a Web or Windows Form.

Crystal Services typically exposes two sub nodes that may be expandable, depending on the version of Crystal Reports that you have currently installed, and on any additional licensing that you may have for Report Application Server (RAS) or Crystal Enterprise. The table that is within the next section below describes the requirements to access a particular node.

Wrapper classes

When you drag a report from Crystal Services onto a Web or Windows Form, this creates a wrapper class instance that references the report in the Web or Windows Form Designer generated code region of the code-behind class.

Note

The wrapper class type varies across versions of Crystal Reports. See the table below.

The Crystal Services listed in the table below expose wrapper class types that do not contain an object model; they depend upon the limited object model provided with the CrystalReportViewer control.

  • The first two rows of the table show the Crystal Services that are included with Crystal Reports for Visual Studio .NET 2002 and 2003. These Crystal Services expose groups of reports, either from the local file directory or from the WCS (Web Component Server) of Crystal Enterprise. The reports are contained in two different wrapper classes: ServerFileReport for reports from the local file directory, or EnterpriseReport for reports from the WCS server of Crystal Enterprise.
  • The last two rows of the table show the Crystal Services that are included with Crystal Reports 9. These Crystal Services expose groups of reports that are served from an unmanaged RAS server or a managed RAS server (see Report Application Server (RAS)). These reports are contained in a common wrapper class that applies to both EnterpriseReportDocument scenarios.
Wrapper class exposed through Crystal Services
Node name under Crystal Services
Crystal Reports versions
Description
What is required to access this node?
ServerFileReport
Server Files
Crystal Reports for Visual Studio .NET 2002 and 2003

(node is replaced when Crystal Reports 9 or 10 installed)

Exposes reports from the local file directory through a common Web service, ServerFileReportService. For more information, see Binding to Server Files (VS .NET 2003).
1. Install Crystal Services.

2. Configure permissions for ASPNET users. (See Binding to Server Files (VS .NET 2003).)

EnterpriseReport
Crystal Enterprise
Crystal Reports for Visual Studio .NET 2002 and 2003

(node is replaced when Crystal Reports 9 or 10 installed)

Accesses Report Web Services exposed by the WCS server of Crystal Enterprise 8, 8.5, 9 or 10 through a common Web service, EnterpriseReportService. For more information, see Binding to Crystal Enterprise (VS .NET 2003).
1. Install Crystal Services.

2. You need access to a Crystal Enterprise installation (which exposes Enterprise reports through its WCS server).

EnterpriseReportDocument
Report Application Server
Crystal Reports 9

(node is replaced when Crystal Reports 10 installed)

Accesses reports exposed by the unmanaged RAS server using a wrapper class, EnterpriseReportDocument. For more information, see Binding to Report Application Server (Crystal Reports 9 and up).
Install an unmanaged RAS server.
EnterpriseReportDocument
Crystal Enterprise
Crystal Reports 9

(node is replaced when Crystal Reports 10 installed)

Accesses reports exposed by the managed RAS server, with a wrapper class, EnterpriseReportDocument. For more information, see Binding to Crystal Enterprise (Crystal Reports 9).
You must install Crystal Enterprise.

For information about Crystal Services that expose ReportDocument wrapper classes, see ReportDocument Binding Scenarios that Use Crystal Services (VS.NET 2002 and 2003).

In this section: