ReportingService2005.SetProperties(String, Property[]) Metodo

Definizione

Spazio dei nomi:

ReportService2005

Assembly:

ReportService2005.dll

Imposta una o più proprietà di un elemento specificato.

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())

Parametri

Item

String

Percorso completo dell'elemento.

Properties

Property[]

Matrice di oggetti Property che definisce le proprietà e i valori da impostare per l'elemento.

Esempio

Per compilare l'esempio di codice seguente, è necessario fare riferimento alla Reporting Services WSDL e importare determinati spazi dei nomi. Per altre informazioni, vedere Compilazione ed esecuzione di esempi di codice. Nell'esempio di codice seguente viene impostata una nuova descrizione per il report Vendite aziendali:

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);  
      }  
   }  
}  

Commenti

Nella tabella seguente vengono mostrate le informazioni sull'intestazione e sulle autorizzazioni relative a questa operazione.

Intestazioni SOAP	(In) BatchHeaderValue (Out) ServerInfoHeaderValue
Autorizzazioni necessarie	Dipende dal tipo di elemento: - Folder: UpdateProperties - Report: UpdateProperties - Resource: UpdateProperties - DataSource: UpdateProperties - Model: UpdateProperties

È possibile creare nuove proprietà definite dall'utente per un elemento passando un Property oggetto come argomento del metodo. Per rimuovere una proprietà da un elemento, impostare la proprietà su un valore vuoto. Non è possibile rimuovere proprietà riservate. Per un elenco di proprietà dell'elemento riservato, vedere Proprietà elemento del server di report.

Se una proprietà specificata non esiste quando viene chiamato il SetProperties metodo, la proprietà viene creata e impostata sul valore specificato. Se la proprietà esiste già, il relativo valore viene sovrascritto. L'impostazione di un valore vuoto per una proprietà che non esiste non ha alcun effetto sull'elemento o sulle relative proprietà.

Se si verifica un errore, non vengono impostate proprietà.