ReportingService2005.GetProperties(String, Property[]) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Retorna o valor de uma ou mais propriedades de um item no banco de dados do servidor de relatórios.
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 completo do caminho ou o ID do item.
- Properties
- Property[]
Um array de Property objetos que contém as propriedades para as quais você quer recuperar valores.
Retornos
Um array de Property objetos que representa as propriedades do item especificado.
Exemplos
Para compilar esse exemplo de código, você deve consultar o Reporting Services WSDL e importar certos namespaces. Para mais informações, veja Exemplos de Código Compilando e Executando. O exemplo de código a seguir utiliza o GetProperties método para recuperar a descrição associada ao relatório de 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 abaixo mostra informações sobre cabeçalhos e permissões sobre esta operação.
| Cabeçalhos SOAP | (Em) ItemNamespaceHeaderValue (Fora) 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 completo do caminho. Para fornecer um ID, você deve definir o ItemNamespaceHeader cabeçalho SOAP. Para mais informações, veja Definir o espaço de nomes do item para o método GetProperties.
Use o GetProperties método para recuperar o conjunto completo de propriedades definidas e reservadas pelo usuário. Para recuperar o subconjunto padrão de propriedades reservadas, use o ListChildren método. Para uma lista das propriedades reservadas dos itens no banco de dados do servidor de relatórios, veja 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 são retornadas. Essas incluem todas as propriedades definidas pelo usuário e embutidas que são específicas para o item.
Você pode passar o nome completo do caminho do item para o Item parâmetro ou pode passar o ID do item. Para mais informações sobre o uso de cabeçalhos SOAP para isso, veja Uso de Cabeçalhos SOAP do Reporting Services.