ReportingService2005.CreateLinkedReport Método

Definición

Espacio de nombres:

ReportService2005

Ensamblado:

ReportService2005.dll

Agrega un nuevo informe vinculado a la base de datos del servidor de informes.

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

Nombre del nuevo informe vinculado.

Parent

String

Dirección URL completa de la carpeta principal a la que agregar el nuevo informe.

Link

String

Dirección URL completa del informe que se utilizará para la definición de informe.

Properties

Property[]

Matriz de objetos Property que define los nombres de propiedad y valores que establecer para el informe vinculado.

Ejemplos

Para compilar este ejemplo de código, debe hacer referencia al Reporting Services WSDL e importar determinados espacios de nombres. Para obtener más información, vea Compilar y ejecutar ejemplos de código. En el ejemplo de código siguiente se crea un informe 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());   
      }  
   }  
}  

Comentarios

En la siguiente tabla se muestra la información de encabezado y de permisos de esta operación.

Encabezados SOAP	(In) BatchHeaderValue (Out) ServerInfoHeaderValue
Permisos necesarios	CreateReporton AND ReadProperties on ParentReport

La longitud de los parámetros y Link no puede superar los Parent 260 caracteres; de lo contrario, se produce una excepción SOAP con el código de error rsItemLengthExceeded.

Los Parent parámetros y Link no pueden ser nulos ni estar vacíos ni contener los siguientes caracteres reservados: : ? ; @ & = + $ , \ * > < | . ". Puede usar el carácter de barra diagonal (/) para separar los elementos del nombre de ruta de acceso completo de la carpeta, pero no puede usarlo al final del nombre de la carpeta.

Un informe vinculado tiene las mismas propiedades que un informe estándar, pero no contiene su propia definición de informe. Un informe vinculado no puede hacer referencia a otro informe vinculado.

El creador de un informe vinculado debe tener permiso para leer la definición del informe al que hace referencia el informe vinculado; sin embargo, este nivel de permiso no es necesario para ejecutar un informe vinculado.

El uso del CreateLinkedReport método cambia las ModifiedBy propiedades y ModifiedDate de la carpeta primaria.