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 do caminho completo do item.

Properties

Property[]

Uma matriz de objetos Property que define as propriedades e os valores a serem definidos para o item.

Exemplos

Para compilar o exemplo de código a seguir, 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 define uma nova descrição para o 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  

      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 a seguir mostra o cabeçalho e as informações de permissão sobre esta operação.

Cabeçalhos SOAP	(In) BatchHeaderValue (Out) 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 um argumento de método. Para remover uma propriedade de um item, defina a propriedade como um valor vazio. Não é possível remover propriedades reservadas. Para obter uma lista de propriedades de item reservadas, consulte Propriedades do item do servidor de relatório.

Se uma propriedade especificada não existir quando o SetProperties método for chamado, a propriedade será criada e definida como o valor fornecido. Se a propriedade já existir, seu valor será substituído. 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 será definida.