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

Definição

Namespace:

ReportService2005

Assembly:

ReportService2005.dll

Retorna o valor de uma ou mais propriedades de um item do banco de dados do servidor de relatório.

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

O nome de caminho completo ou a ID do item.

Properties

Property[]

Uma matriz de objetos Property que contém as propriedades para as quais você deseja recuperar valores.

Retornos

Property[]

Uma matriz de Property objetos que representa as propriedades do item especificado.

Exemplos

Para compilar esse exemplo de código, você deve referenciar o WSDL Reporting Services e importar determinados namespaces. Para obter mais informações, consulte Compilando e executando exemplos de código. O exemplo de código a seguir usa o GetProperties método para recuperar a descrição associada ao relatório Vendas da 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() );  
      }  
   }  
}  

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) ItemNamespaceHeaderValue (Out) ServerInfoHeaderValue
Permissões necessárias	Depende do tipo de item: - Folder: ReadProperties - Report: ReadProperties - Resource: ReadProperties - DataSource: ReadProperties - Model: ReadProperties

O valor padrão que deve ser passado para esse argumento é o nome do caminho completo. Para fornecer uma ID, você deve definir o ItemNamespaceHeader cabeçalho SOAP. Para obter mais informações, consulte Configurando o namespace de item para o método GetProperties.

Use o GetProperties método para recuperar o conjunto completo de propriedades definidas pelo usuário e reservadas. Para recuperar o subconjunto padrão de propriedades reservadas, use o ListChildren método . Para obter uma lista das propriedades reservadas dos itens no banco de dados do servidor de relatório, consulte Propriedades do item do servidor de relatório.

Se o Properties parâmetro for null (Nothing no Visual Basic), todas as propriedades do item especificado serão retornadas. Elas incluem todas as propriedades internas e definidas pelo usuário específicas do item.

Você pode passar o nome do caminho completo do item para o Item parâmetro ou passar a ID do item. Para obter mais informações sobre como usar cabeçalhos SOAP para fazer isso, consulte Usando Reporting Services cabeçalhos SOAP.