ReportingService2005.CreateReport Metode

Definisi

Ruang nama:

ReportService2005

Rakitan:

ReportService2005.dll

Menambahkan laporan baru ke database server laporan.

public:
 cli::array <ReportService2005::Warning ^> ^ CreateReport(System::String ^ Report, System::String ^ Parent, bool Overwrite, cli::array <System::Byte> ^ Definition, cli::array <ReportService2005::Property ^> ^ Properties);

public ReportService2005.Warning[] CreateReport (string Report, string Parent, bool Overwrite, byte[] Definition, ReportService2005.Property[] Properties);

member this.CreateReport : string * string * bool * byte[] * ReportService2005.Property[] -> ReportService2005.Warning[]

Public Function CreateReport (Report As String, Parent As String, Overwrite As Boolean, Definition As Byte(), Properties As Property()) As Warning()

Parameter

Report

String

Nama laporan baru.

Parent

String

URL folder induk yang sepenuhnya memenuhi syarat untuk menambahkan laporan.

Overwrite

Boolean

Ekspresi Boolean yang menunjukkan apakah laporan yang ada dengan nama yang sama di lokasi yang ditentukan harus ditimpa.

Definition

Byte[]

Definisi laporan untuk diterbitkan ke server laporan, yang merupakan konten file .rdl. Data XML ditentukan oleh http://schemas.microsoft.com/sqlserver/reporting/2008/01/reportdefinition/ Bahasa Definisi Laporan .

Properties

Property[]

Array Property objek yang berisi nama dan nilai properti yang akan diatur untuk laporan.

Mengembalikan

Warning[]

Array Warning objek yang menjelaskan peringatan apa pun yang terjadi saat definisi laporan divalidasi.

Contoh

Untuk mengkompilasi contoh kode ini, Anda harus mereferensikan Reporting Services WSDL dan mengimpor namespace tertentu. Untuk informasi selengkapnya, lihat Mengkompilasi dan Menjalankan Contoh Kode. Contoh kode berikut menerbitkan laporan dalam bentuk file Report Definition Language (RDL) ke database server laporan.

Imports System  
Imports System.IO  
Imports System.Web.Services.Protocols  

Class Sample  
   Public Shared Sub Main()  
      Dim rs As New ReportingService2005()  
      rs.Credentials = System.Net.CredentialCache.DefaultCredentials  

      Dim definition As [Byte]() = Nothing  
      Dim warnings As Warning() = Nothing  
      Dim name As String = "MyReport"  

      Try  
         Dim stream As FileStream = File.OpenRead("MyReport.rdl")  
         definition = New [Byte](stream.Length - 1) {}  
         stream.Read(definition, 0, CInt(stream.Length - 1))  
         stream.Close()  

      Catch e As IOException  
         Console.WriteLine(e.Message)  
      End Try  

      Try  
         warnings = rs.CreateReport(name, "/Samples", False, definition, Nothing)  

         If Not (warnings Is Nothing) Then  
            Dim warning As Warning  
            For Each warning In  warnings  
               Console.WriteLine(warning.Message)  
            Next warning  

         Else  
            Console.WriteLine("Report: {0} created successfully with no warnings", name)  
         End If  

      Catch e As SoapException  
         Console.WriteLine(e.Detail.InnerXml.ToString())  
      End Try  
   End Sub 'Main   
End Class 'Sample  

using System;  
using System.IO;  
using System.Web.Services.Protocols;  

class Sample  
{  
   public static void Main()  
   {  
      ReportingService2005 rs = new ReportingService2005();  
      rs.Credentials = System.Net.CredentialCache.DefaultCredentials;  

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

      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  
      {  
         warnings = rs.CreateReport(name, "/Samples", false, definition, null);  

         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());  
      }  

   }  
}  

Keterangan

Tabel di bawah ini memperlihatkan informasi header dan izin pada operasi ini.

Header SOAP	(Dalam) BatchHeaderValue (Keluar) ServerInfoHeaderValue
Memerlukan izin	Membuat laporan baru: CreateReport pada Parent AND ReadProperties pada sumber data laporan DAN ReadProperties pada himpunan data laporan Memperbarui laporan yang sudah ada: UpdateReportDefinition pada AND UpdateProperties pada ReportReport (jika Properties berisi properti) DAN UpdateProperties pada sumber data laporan DAN UpdateProperties pada himpunan data laporan

Panjang Parent parameter tidak boleh melebihi 260 karakter; jika tidak, pengecualian SOAP dilemparkan dengan kode kesalahan rsItemLengthExceeded.

Parameter Parent tidak boleh null atau kosong atau berisi karakter khusus berikut: : ? ; @ & = + $ , \ * > < | . ". Anda dapat menggunakan karakter garis miring (/) untuk memisahkan item dalam nama jalur lengkap folder, tetapi Anda tidak dapat menggunakannya di akhir nama folder.

Jika terjadi kesalahan, laporan tidak dibuat.

Menambahkan laporan ke database server laporan memodifikasi ModifiedBy properti dan ModifiedDate folder induk.