ReportingService2005.CreateLinkedReport Méthode

Définition

Ajoute un nouveau rapport lié à la base de données du serveur de rapports.

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

Paramètres

Report
String

Nom du nouveau rapport lié.

Parent
String

URL complète du dossier parent auquel ajouter le nouveau rapport.

Link
String

URL complète du rapport qui sera utilisée pour la définition de rapport.

Properties
Property[]

Tableau d'objets Property qui définit les noms et valeurs des propriétés à définir pour le rapport lié.

Exemples

Pour compiler cet exemple de code, vous devez référencer le Reporting Services WSDL et importer certains espaces de noms. Pour plus d’informations, consultez Compilation et exécution d’exemples de code. L’exemple de code suivant crée un rapport lié :

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

Remarques

Le tableau suivant présente les informations relatives aux en-têtes et aux autorisations sur cette opération.

En-têtes SOAP (In) BatchHeaderValue

(Out) ServerInfoHeaderValue
Autorisations requises CreateReport on Parent AND ReadProperties on Report

La longueur des Parent paramètres et Link ne peut pas dépasser 260 caractères ; sinon, une exception SOAP est levée avec le code d’erreur rsItemLengthExceeded.

Les Parent paramètres et Link ne peuvent pas être null ou vides ou contenir les caractères réservés suivants : : ? ; @ & = + $ , \ * > < | . ". Vous pouvez utiliser la barre oblique (/) pour séparer les éléments dans le nom complet du chemin d’accès du dossier, mais vous ne pouvez pas l’utiliser à la fin du nom du dossier.

Un rapport lié a les mêmes propriétés qu’un rapport standard, mais il ne contient pas sa propre définition de rapport. Un rapport lié ne peut pas référencer un autre rapport lié.

Le créateur d’un rapport lié doit être autorisé à lire la définition du rapport auquel le rapport lié fait référence ; Toutefois, ce niveau d’autorisation n’est pas nécessaire pour exécuter un rapport lié.

L’utilisation de la CreateLinkedReport méthode modifie les ModifiedBy propriétés et ModifiedDate du dossier parent.

S’applique à