ReportingService2005.GetProperties(String, Property[]) Método

Definición

Espacio de nombres:

ReportService2005

Ensamblado:

ReportService2005.dll

Devuelve el valor de una o varias propiedades de un elemento de la base de datos del servidor de informes.

public:
 cli::array <ReportService2005::Property ^> ^ GetProperties(System::String ^ Item, cli::array <ReportService2005::Property ^> ^ Properties);

public ReportService2005.Property[] GetProperties (string Item, ReportService2005.Property[] Properties);

member this.GetProperties : string * ReportService2005.Property[] -> ReportService2005.Property[]

Public Function GetProperties (Item As String, Properties As Property()) As Property()

Parámetros

Item

String

Nombre completo de la ruta de acceso o el identificador del elemento.

Properties

Property[]

Matriz de objetos Property que contiene las propiedades para las que desea recuperar los valores.

Devoluciones

Property[]

Matriz de Property objetos que representa las propiedades del elemento especificado.

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 usa el GetProperties método para recuperar la descripción asociada al informe Ventas de empresa:

Imports System  
Imports System.Web.Services.Protocols  

Class Sample  
   Public Shared Sub Main()  
      Dim rs As New ReportingService2005()  
      rs.Credentials = System.Net.CredentialCache.DefaultCredentials  

      ' Create the property to retrieve.  
      Dim retrieveProp As New [Property]()  
      retrieveProp.Name = "Description"  
      Dim props(0) As [Property]  
      props(0) = retrieveProp  

      Try  
         Dim properties As [Property]() = rs.GetProperties("/SampleReports/Company Sales", props)  

         Dim prop As [Property]  
         For Each prop In  properties  
            ' Writes the description to the console.  
            Console.WriteLine(prop.Value)  
         Next prop  

      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;  

      // Create the property to retrieve.  
      Property retrieveProp = new Property();  
      retrieveProp.Name = "Description";  
      Property[] props = new Property[1];  
      props[0] = retrieveProp;  

      try  
      {  
         Property[] properties = rs.GetProperties("/SampleReports/Company Sales", props);  

         foreach (Property prop in properties)  
         {  
            // Writes the description to the console.  
            Console.WriteLine(prop.Value);  
         }  
      }  

      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) ItemNamespaceHeaderValue (Out) ServerInfoHeaderValue
Permisos necesarios	Depende del tipo de elemento: - Folder: ReadProperties - Report: ReadProperties - Resource: ReadProperties - DataSource: ReadProperties - Model: ReadProperties

El valor predeterminado que se debe pasar para este argumento es el nombre de ruta de acceso completo. Para proporcionar un identificador, debe establecer el ItemNamespaceHeader encabezado SOAP. Para obtener más información, vea Establecer el espacio de nombres de elemento para el método GetProperties.

Use el GetProperties método para recuperar el conjunto completo de propiedades reservadas y definidas por el usuario. Para recuperar el subconjunto estándar de propiedades reservadas, use el ListChildren método . Para obtener una lista de las propiedades reservadas de los elementos de la base de datos del servidor de informes, vea Propiedades del elemento del servidor de informes.

Si el Properties parámetro es null (Nothing en Visual Basic), se devuelven todas las propiedades del elemento especificado. Entre ellas se incluyen todas las propiedades integradas y definidas por el usuario que son específicas del elemento.

Puede pasar el nombre de ruta de acceso completa del elemento para el Item parámetro o puede pasar el identificador del elemento. Para obtener más información sobre el uso de encabezados SOAP para ello, vea Uso de encabezados SOAP Reporting Services.