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
Nome e percorso completo o ID dell'elemento.
- Properties
- Property[]
Matrice di oggetti Property contenente le proprietà per le quali si desidera recuperare i valori.
Restituisce
Matrice di oggetti Property che rappresenta le proprietà dell'elemento specificato.
Esempio
Per compilare questo esempio di codice, è 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 usato il GetProperties metodo per recuperare la descrizione associata al 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
' 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
Nella tabella seguente vengono mostrate le informazioni sull'intestazione e sulle autorizzazioni relative a questa operazione.
Intestazioni SOAP | (In) ItemNamespaceHeaderValue (Out) ServerInfoHeaderValue |
Autorizzazioni necessarie | Dipende dal tipo di elemento: - 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 specificare un ID, è necessario impostare l'intestazione ItemNamespaceHeader SOAP. Per altre informazioni, vedere Impostazione dello spazio dei nomi item per il metodo GetProperties.
Usare il metodo per recuperare il GetProperties set completo di proprietà definite dall'utente e riservate. Per recuperare il subset standard di proprietà riservate, usare il ListChildren metodo . Per un elenco delle proprietà riservate degli elementi nel database del server di report, vedere Proprietà elemento del server di report.
Se il Properties
parametro è null
(Nothing
in Visual Basic), vengono restituite tutte le proprietà per l'elemento specificato. Includono tutte le proprietà definite dall'utente e predefinite specifiche per l'elemento.
È possibile passare il nome completo del percorso dell'elemento per il Item
parametro oppure passare l'ID dell'elemento. Per altre informazioni sull'uso di intestazioni SOAP per eseguire questa operazione, vedere Uso di Reporting Services intestazioni SOAP.