ReportingService2005.SetProperties(String, Property[]) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 al Reporting Services WSDL e importare determinati spazi dei nomi. Per ulteriori informazioni, vedere compilazione ed esecuzione di esempi di codice. Nell'esempio di codice seguente viene impostata una nuova descrizione per il report Company Sales:
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 le proprietà riservate. Per un elenco delle proprietà degli elementi riservati, vedere proprietà degli elementi del server di report.
Se una proprietà specificata non esiste quando SetProperties viene chiamato il 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à inesistente non ha alcun effetto sull'elemento o sulle relative proprietà.
Se si verifica un errore, non viene impostata alcuna proprietà.