ReportingService2005.GetProperties(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.
Restituisce il valore di una o più proprietà di un elemento nel database del server di report.
public:
cli::array <ReportService2005::Property ^> ^ GetProperties(System::String ^ Item, cli::array <ReportService2005::Property ^> ^ Properties);
public ReportService2005.Property[] GetProperties(string Item, ReportService2005.Property[] Properties);
member this.GetProperties : string * ReportService2005.Property[] -> ReportService2005.Property[]
Public Function GetProperties (Item As String, Properties As Property()) As Property()
Parametri
- Item
- String
Il nome completo del percorso o l'ID dell'oggetto.
- Properties
- Property[]
Un array di Property oggetti che contiene le proprietà per cui vuoi recuperare i valori.
Valori restituiti
Un array di Property oggetti che rappresenta le proprietà dell'elemento specificato.
Esempio
Per compilare questo 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 utilizza il GetProperties metodo per recuperare la descrizione associata al rapporto Vendite dell'Azienda:
Imports System
Imports System.Web.Services.Protocols
Class Sample
Public Shared Sub Main()
Dim rs As New ReportingService2005()
rs.Credentials = System.Net.CredentialCache.DefaultCredentials
' Create the property to retrieve.
Dim retrieveProp As New [Property]()
retrieveProp.Name = "Description"
Dim props(0) As [Property]
props(0) = retrieveProp
Try
Dim properties As [Property]() = rs.GetProperties("/SampleReports/Company Sales", props)
Dim prop As [Property]
For Each prop In properties
' Writes the description to the console.
Console.WriteLine(prop.Value)
Next prop
Catch e As SoapException
Console.WriteLine(e.Detail.InnerXml.ToString())
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;
// Create the property to retrieve.
Property retrieveProp = new Property();
retrieveProp.Name = "Description";
Property[] props = new Property[1];
props[0] = retrieveProp;
try
{
Property[] properties = rs.GetProperties("/SampleReports/Company Sales", props);
foreach (Property prop in properties)
{
// Writes the description to the console.
Console.WriteLine(prop.Value);
}
}
catch ( SoapException e )
{
Console.WriteLine( e.Detail.InnerXml.ToString() );
}
}
}
Commenti
La tabella sottostante mostra informazioni sull'intestazione e sui permessi di questa operazione.
| Intestazioni SOAP | (Dentro) ItemNamespaceHeaderValue (Fuori) ServerInfoHeaderValue |
| Autorizzazioni necessarie | Dipende dal tipo di oggetto: - Folder: ReadProperties- Report: ReadProperties- Resource: ReadProperties- DataSource: ReadProperties- Model: ReadProperties |
Il valore predefinito che deve essere passato per questo argomento è il nome completo del percorso. Per fornire un ID, devi impostare l'intestazione ItemNamespaceHeader SOAP. Per maggiori informazioni, vedi Impostazione dello spazio dei nomi degli oggetti per il metodo GetProperties.
Usa il GetProperties metodo per recuperare l'insieme completo di proprietà definite e riservate dall'utente. Per recuperare il sottoinsieme standard delle proprietà riservate, si utilizza il ListChildren metodo. Per un elenco delle proprietà riservate degli elementi nel database del server di report, vedi Proprietà degli oggetti del server di report.
Se il parametro Properties è null (Nothing in Visual Basic), tutte le proprietà dell'elemento specificato vengono restituite. Queste includono tutte le proprietà definite dall'utente e quelle integrate specifiche per l'oggetto.
Puoi passare il nome completo del percorso dell'elemento per il Item parametro oppure puoi passare l'ID dell'elemento. Per ulteriori informazioni sull'uso delle intestazioni SOAP per raggiungere questo scopo, vedi Using Reporting Services SOAP Headers.