ReportingService2005.CreateLinkedReport Methode

Referenz

Definition

Namespace:: ReportService2005

Assembly:: ReportService2005.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Fügt der Berichtsserver-Datenbank einen neuen verknüpften Bericht hinzu.

public:
 void CreateLinkedReport(System::String ^ Report, System::String ^ Parent, System::String ^ Link, cli::array <ReportService2005::Property ^> ^ Properties);

public void CreateLinkedReport (string Report, string Parent, string Link, ReportService2005.Property[] Properties);

member this.CreateLinkedReport : string * string * string * ReportService2005.Property[] -> unit

Public Sub CreateLinkedReport (Report As String, Parent As String, Link As String, Properties As Property())

Parameter

Report: String

Der Name des neuen verknüpften Berichts.

Parent: String

Die vollqualifizierte URL des übergeordneten Ordners, dem der neue Bericht hinzugefügt werden soll.

Link: String

Die vollqualifizierte URL des Berichts, der für die Berichtsdefinition verwendet wird.

Properties: Property[]

Ein Array von Property-Objekten, das die Eigenschaftennamen und die Werte definiert, die für den verknüpften Bericht festgelegt werden sollen.

Beispiele

Um dieses Codebeispiel zu kompilieren, müssen Sie auf die Reporting Services WSDL verweisen und bestimmte Namespaces importieren. Weitere Informationen finden Sie unter Kompilieren und Ausführen von Codebeispielen. Im folgenden Codebeispiel wird ein verknüpfter Bericht erstellt:

Imports System  
Imports System.Web.Services.Protocols  

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

      Dim prop As New [Property]()  
      prop.Name = "Description"  
      prop.Value = "A new linked report"  
      Dim props(0) As [Property]  
      props(0) = prop  

      Try  
         rs.CreateLinkedReport("Employee Sales Report2", "/SampleReports", "/SampleReports/Employee Sales Summary", props)  

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

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

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

      Property prop = new Property();  
      prop.Name = "Description";  
      prop.Value = "A new linked report";  
      Property[] props = new Property[1];  
      props[0] = prop;  

      try  
      {  
         rs.CreateLinkedReport("Employee Sales Report2", "/SampleReports",  
            "/SampleReports/Employee Sales Summary", props);  
      }  

      catch (SoapException e)  
      {  
         Console.WriteLine(e.Detail.InnerXml.ToString());   
      }  
   }  
}

Hinweise

In der folgenden Tabelle werden Header- und Berechtigungsinformationen zu diesem Vorgang dargestellt.


SOAP-Header	(In) BatchHeaderValue (Out) ServerInfoHeaderValue
Erforderliche Berechtigungen	CreateReport auf `Parent` AND ReadProperties auf `Report`

Die Länge der Parent Parameter und Link darf 260 Zeichen nicht überschreiten. Andernfalls wird eine SOAP-Ausnahme mit dem Fehlercode rsItemLengthExceeded ausgelöst.

Die Parent Parameter und Link dürfen nicht NULL oder leer sein oder die folgenden reservierten Zeichen enthalten: : ? ; @ & = + $ , \ * > < | . ". Sie können den Schrägstrich (/) verwenden, um Elemente im vollständigen Pfadnamen des Ordners zu trennen, aber sie können es nicht am Ende des Ordnernamens verwenden.

Ein verknüpfter Bericht verfügt über dieselben Eigenschaften wie ein Standardbericht, enthält aber keine eigene Berichtsdefinition. Ein verknüpfter Bericht kann nicht auf einen anderen verknüpften Bericht verweisen.

Der Ersteller eines verknüpften Berichts muss über die Berechtigung verfügen, die Definition des Berichts zu lesen, auf den der verknüpfte Bericht verweist; Diese Berechtigungsstufe ist jedoch nicht erforderlich, um einen verknüpften Bericht auszuführen.

Mit der CreateLinkedReport -Methode werden die ModifiedBy Eigenschaften und ModifiedDate des übergeordneten Ordners geändert.

Gilt für:

Freigeben über