Compartilhar via


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

Definição

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

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.

Aplica-se a