ReportingService2005.CreateLinkedReport Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Aggiunge un nuovo report collegato al database del server di report.
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())
Parametri
- Report
- String
Nome del nuovo report collegato.
- Parent
- String
URL completo della cartella padre nella quale aggiungere il nuovo report.
- Link
- String
URL completo del report che verrà utilizzato per la relativa definizione.
- Properties
- Property[]
Matrice di oggetti Property che definisce i nomi e i valori delle proprietà da impostare per il report collegato.
Esempio
Per compilare questo esempio di codice, è necessario fare riferimento alla Reporting Services WSDL e importare determinati spazi dei nomi. Per altre informazioni, vedere Compilazione ed esecuzione di esempi di codice. Nell'esempio di codice seguente viene creato un report collegato:
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());
}
}
}
Commenti
Nella tabella seguente vengono mostrate le informazioni sull'intestazione e sulle autorizzazioni relative a questa operazione.
Intestazioni SOAP | (In) BatchHeaderValue (Out) ServerInfoHeaderValue |
Autorizzazioni necessarie | CreateReporton AND ReadProperties on Parent Report |
La lunghezza dei Parent
parametri e Link
non può superare i 260 caratteri. In caso contrario, viene generata un'eccezione SOAP con il codice di errore rsItemLengthExceeded.
I Parent
parametri e Link
non possono essere null o vuoti o contengono i caratteri riservati seguenti: : ? ; @ & = + $ , \ * > < | . "
. È possibile utilizzare il carattere barra (/) per separare gli elementi nel nome completo del percorso della cartella, ma non è possibile usarlo alla fine del nome della cartella.
Un report collegato ha le stesse proprietà di un report standard, ma non contiene una propria definizione di report. Un report collegato non può fare riferimento a un altro report collegato.
L'autore di un report collegato deve disporre dell'autorizzazione per leggere la definizione del report a cui fa riferimento il report collegato; Tuttavia, questo livello di autorizzazione non è necessario per eseguire un report collegato.
L'uso del CreateLinkedReport metodo modifica le ModifiedBy proprietà e ModifiedDate della cartella padre.