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

Definição

Namespace:

ReportService2005

Assembly:

ReportService2005.dll

Define uma ou mais propriedades de um item especificado.

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

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

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

Public Sub SetProperties (Item As String, Properties As Property())

Parâmetros

Item

String

O nome completo do caminho do item.

Properties

Property[]

Um array de Property objetos que define as propriedades e valores a serem definidos para o item.

Exemplos

Para compilar o exemplo de código a seguir, você deve consultar o WSDL do Reporting Services e importar certos namespaces. Para mais informações, veja Exemplos de Código Compilando e Executando. O exemplo de código a seguir estabelece uma nova descrição para o 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  

      Dim props(0) As [Property]  
      Dim setProp As New [Property]()  
      setProp.Name = "Description"  
      setProp.Value = "Sales by quarter and product category."  
      props(0) = setProp  

      Dim itemPath As String = "/SampleReports/Company Sales"  

      Try  
         rs.SetProperties(itemPath, props)  
         Console.WriteLine("New description set on item {0}.", itemPath)  

      Catch ex As SoapException  
         Console.WriteLine(ex.Detail.OuterXml)  
      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;  

      Property[] props = new Property[1];  
      Property setProp = new Property();  
      setProp.Name = "Description";  
      setProp.Value = "Sales by quarter and product category.";  
      props[0] = setProp;  

      string itemPath = "/SampleReports/Company Sales";   

      try  
      {  
         rs.SetProperties(itemPath, props);  
         Console.WriteLine("New description set on item {0}.", itemPath);  
      }  

      catch (SoapException ex)  
      {  
         Console.WriteLine(ex.Detail.OuterXml);  
      }  
   }  
}  

Comentários

A tabela abaixo mostra informações sobre cabeçalhos e permissões sobre esta operação.

Cabeçalhos SOAP	(Em) BatchHeaderValue (Fora) ServerInfoHeaderValue
Permissões necessárias	Depende do tipo de item: - Folder: UpdateProperties - Report: UpdateProperties - Resource: UpdateProperties - DataSource: UpdateProperties - Model: UpdateProperties

Você pode criar novas propriedades definidas pelo usuário para um item passando um Property objeto como argumento de método. Para remover uma propriedade de um item, defina a propriedade para um valor vazio. Você não pode remover propriedades reservadas. Para uma lista das propriedades dos itens reservados, veja Propriedades do Item do Servidor de Relatórios.

Se uma propriedade especificada não existir quando o SetProperties método for chamado, a propriedade é criada e definida para o valor que você fornece. Se a propriedade já existir, seu valor é sobrescrevido. Definir um valor vazio para uma propriedade que não existe não tem efeito sobre o item ou suas propriedades.

Se ocorrer um erro, nenhuma propriedade é definida.