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

Il nome completo del percorso dell'oggetto.

Properties
Property[]

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

Esempio

Per compilare il seguente esempio di codice, devi fare riferimento al WSDL di Reporting Services e importare determinati namespace. Per maggiori informazioni, vedi Compiling and Conducting Code Examples. Il seguente esempio di codice stabilisce una nuova descrizione per il rapporto Vendite della Società:

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

La tabella sottostante mostra informazioni sull'intestazione e sui permessi di questa operazione.
Intestazioni SOAP (Dentro) BatchHeaderValue

(Fuori) ServerInfoHeaderValue
Autorizzazioni necessarie Dipende dal tipo di oggetto:

- Folder: UpdateProperties
- Report: UpdateProperties
- Resource: UpdateProperties
- DataSource: UpdateProperties
- Model: UpdateProperties

Puoi creare nuove proprietà definite dall'utente per un elemento passando un Property oggetto come argomento di metodo. Per rimuovere una proprietà da un elemento, imposta la proprietà a un valore vuoto. Non puoi rimuovere le proprietà riservate. Per un elenco delle proprietà degli elementi riservati, vedi Proprietà degli oggetti del Report Server.

Se una proprietà specificata non esiste quando il SetProperties metodo viene chiamato, la proprietà viene creata e impostata al valore che fornisci. Se la proprietà esiste già, il suo valore viene sovrascritto. Impostare un valore vuoto per una proprietà che non esiste non ha alcun effetto sull'oggetto o sulle sue proprietà.

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

Si applica a