ReportingService2010.CreateLinkedItem Metodo

Riferimento

Definizione

Spazio dei nomi:: ReportService2010

Assembly:: ReportService2010.dll

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 elemento collegato al database del server di report.

public:
 void CreateLinkedItem(System::String ^ ItemPath, System::String ^ Parent, System::String ^ Link, cli::array <ReportService2010::Property ^> ^ Properties);

[System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateLinkedItem", ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped, RequestNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", ResponseNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", Use=System.Web.Services.Description.SoapBindingUse.Literal)]
[System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")]
[System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)]
public void CreateLinkedItem (string ItemPath, string Parent, string Link, ReportService2010.Property[] Properties);

[<System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateLinkedItem", ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped, RequestNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", ResponseNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", Use=System.Web.Services.Description.SoapBindingUse.Literal)>]
[<System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")>]
[<System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)>]
member this.CreateLinkedItem : string * string * string * ReportService2010.Property[] -> unit

Public Sub CreateLinkedItem (ItemPath As String, Parent As String, Link As String, Properties As Property())

Parametri

ItemPath: String

Nome file del nuovo elemento collegato, incluso il nome del file.

Parent: String

URL completo della cartella padre nella quale aggiungere il nuovo elemento.

Link: String

URL completo dell'elemento 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 l'elemento collegato.

Attributi: SoapDocumentMethodAttribute SoapHeaderAttribute

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 ReportingService2010()  
      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.CreateLinkedItem("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()  
   {  
      ReportingService2010 rs = new ReportingService2010();  
      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.CreateLinkedItem("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.


Utilizzo intestazione SOAP	(In) TrustedUserHeaderValue (Out) ServerInfoHeaderValue
Autorizzazioni necessarie in modalità nativa	CreateReporton AND ReadProperties on `ParentItemPath`
Autorizzazioni necessarie per la modalità SharePoint	Non supportato

La lunghezza dei parametri e Link non può superare i 260 caratteri. In caso contrario, viene generata un'eccezione SOAP con il codice di Parent errore rsItemLengthExceeded.

I Parent parametri e Link non possono essere null o vuoti o contengono i caratteri riservati seguenti: : ? ; @ & = + $ , \ * > < | . ". È possibile usare il carattere barra in avanti (/) per separare gli elementi nel nome completo del percorso della cartella, ma non è possibile usarlo alla fine del nome della cartella

Un elemento collegato ha le stesse proprietà di un elemento del catalogo standard, ma non contiene la propria definizione di elemento. Un elemento collegato non può fare riferimento a un altro elemento collegato.

L'autore di un elemento collegato deve avere l'autorizzazione per leggere la definizione dell'elemento a cui fa riferimento l'elemento collegato; tuttavia, questo livello di autorizzazione non è necessario per eseguire un elemento collegato.

L'uso del CreateLinkedItem metodo modifica le ModifiedBy proprietà e ModifiedDate della cartella padre.

Si applica a

Condividi tramite