ReportingService2005.CreateLinkedReport Método

Definição

Namespace:

ReportService2005

Assembly:

ReportService2005.dll

Adiciona um novo relatório vinculado ao banco de dados do servidor de relatório.

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

Parâmetros

Report

String

O nome do novo relatório vinculado.

Parent

String

A URL totalmente qualificada da pasta pai na qual adicionar o novo relatório.

Link

String

A URL totalmente qualificada do relatório que será usada para a definição de relatório.

Properties

Property[]

Uma matriz de objetos Property que define os nomes e os valores de propriedades a serem definidos para relatório vinculado.

Exemplos

Para compilar esse exemplo de código, você deve referenciar o Reporting Services WSDL e importar determinados namespaces. Para obter mais informações, consulte Compilando e executando exemplos de código. O exemplo de código a seguir cria um relatório vinculado:

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

Comentários

A tabela a seguir mostra o cabeçalho e as informações de permissão sobre esta operação.

Cabeçalhos SOAP	(In) BatchHeaderValue (Out) ServerInfoHeaderValue
Permissões necessárias	CreateReport on Parent AND ReadProperties on Report

O comprimento dos Parent parâmetros e Link não pode exceder 260 caracteres; caso contrário, uma exceção SOAP é gerada com o código de erro rsItemLengthExceeded.

Os Parent parâmetros e Link não podem ser nulos ou vazios ou contêm os seguintes caracteres reservados: : ? ; @ & = + $ , \ * > < | . ". Você pode usar o caractere de barra (/) para separar itens no nome do caminho completo da pasta, mas não pode usá-lo no final do nome da pasta.

Um relatório vinculado tem as mesmas propriedades de um relatório padrão, mas não contém sua própria definição de relatório. Um relatório vinculado não pode fazer referência a outro relatório vinculado.

O criador de um relatório vinculado deve ter permissão para ler a definição do relatório referenciado pelo relatório vinculado; no entanto, esse nível de permissão não é necessário para executar um relatório vinculado.

O uso do CreateLinkedReport método altera as ModifiedBy propriedades e ModifiedDate da pasta pai.