Lenguaje

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

Definición

Devuelve el valor de una o más propiedades de un elemento en 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

El nombre completo de la ruta o el ID del artículo.

Properties
Property[]

Un array de Property objetos que contiene las propiedades para las que quieres recuperar valores.

Devoluciones

Un array de Property objetos que representa las propiedades del elemento especificado.

Ejemplos

Para compilar este ejemplo de código, debes consultar el WSDL de Reporting Services e importar ciertos espacios de nombres. Para más información, consulte Ejemplos de Compilación y Ejecución de Código. El siguiente ejemplo de código utiliza el GetProperties método para recuperar la descripción asociada al informe de ventas de la 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

La siguiente tabla muestra la información sobre cabeceras y permisos sobre esta operación.

Encabezados SOAP (En) ItemNamespaceHeaderValue

(Fuera) ServerInfoHeaderValue
Permisos necesarios Depende del tipo de objeto:

- Folder: ReadProperties
- Report: ReadProperties
- Resource: ReadProperties
- DataSource: ReadProperties
- Model: ReadProperties

El valor por defecto que debe pasarse para este argumento es el nombre completo del camino. Para proporcionar un ID, debes establecer la ItemNamespaceHeader cabecera SOAP. Para más información, consulte Establecer el espacio de nombres de elementos para el método GetProperties.

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

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

Puedes pasar el nombre completo de la ruta del elemento para el Item parámetro o puedes pasar el ID del elemento. Para más información sobre el uso de cabeceras SOAP para lograr esto, consulte Uso de Reporting Services SOAP Headers.

Se aplica a