ReportingService2006.CreateReport Method

Adds a new report to a SharePoint library.

Namespace: ReportService2006
Assembly: ReportService2006 (in reportservice2006.dll)

public CatalogItem CreateReport (
	string Report,
	string Parent,
	bool Overwrite,
	byte[] Definition,
	Property[] Properties,
	out Warning[] Warnings
)
public CatalogItem CreateReport (
	String Report, 
	String Parent, 
	boolean Overwrite, 
	byte[] Definition, 
	Property[] Properties, 
	/** @attribute OutAttribute() */ /** @ref */ Warning[] Warnings
)
JScript does not support passing value-type arguments by reference.

Parameters

Report

The name of the new report including the file name and .rdl file name extension.

Parent

The fully qualified URL for the parent folder that will contain the report.

Overwrite

A Boolean expression that indicates whether an existing report that has the same name in the location specified should be overwritten.

Definition

The report definition to publish to the report server.

Properties

An array of Property objects that contains the property names and values to set for the report.

Warnings

[out] An array of Warning objects that describes any warnings that occurred when the report definition was validated.

Return Value

A CatalogItem object for the newly created report.

If errors occur, the report is not created.

Adding a report to a SharePoint library modifies the ModifiedBy and ModifiedDate properties of the parent folder.

If the .rdl file name extension is excluded from the report name, an rsFileExtensionRequired error will be returned.


using System;
using System.Collections.Generic;
using System.IO;
using System.Text;
using System.Web;
using System.Web.Services;
using System.Web.Services.Protocols;

class Sample
{
    static void Main(string[] args)
    {
        ReportingService2006 rs = new ReportingService2006();
        rs.Url = "http://<Server Name>" +
            "/_vti_bin/ReportServer/ReportService2006.asmx";
        rs.Credentials = 
            System.Net.CredentialCache.DefaultCredentials;

        Byte[] definition = null;
        Warning[] warnings = null;
        string name = "MyReport.rdl";

        try
        {
            FileStream stream = File.OpenRead("MyReport.rdl");
            definition = new Byte[stream.Length];
            stream.Read(definition, 0, (int)stream.Length);
            stream.Close();
        }
        catch (IOException e)
        {
            Console.WriteLine(e.Message);
        }

        try
        {
            string parent = "http://<Server Name>/Docs/Documents/";
            CatalogItem report = rs.CreateReport(name, parent,
                        false, definition, null, out warnings);

            if (warnings != null)
            {
                foreach (Warning warning in warnings)
                {
                    Console.WriteLine(warning.Message);
                }
            }

            else
                Console.WriteLine("Report: {0} created successfully " +
                                  " with no warnings", name);
        }
        catch (SoapException e)
        {
            Console.WriteLine(e.Detail.InnerXml.ToString());
        }
    }
}

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Development Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

Target Platforms

Windows 98, Windows 2000, Windows 2000 Server, Windows CE, Windows Server 2008, Windows 98 Second Edition, Pocket PC, Smart Phone, Windows Server 2003, Windows XP Professional with Service Pack 2 (SP2), Windows 2000 Professional, Windows 2000 Advanced Server, Windows XP Home Edition, For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005., Windows Vista, Windows Mobile 5.0, Windows Mobile 2003 for Pocket PC, Windows CE 5.0

Community Additions

ADD
Show: