ReportingService2010.GetItemParameters Metodo

Riferimento

Definizione

Spazio dei nomi:: ReportService2010

Assembly:: ReportService2010.dll

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 le proprietà del parametro per un elemento specificato. Questo metodo può essere usato anche per convalidare i valori dei parametri rispetto ai parametri di un elemento specificato.

public:
 cli::array <ReportService2010::ItemParameter ^> ^ GetItemParameters(System::String ^ ItemPath, System::String ^ HistoryID, bool ForRendering, cli::array <ReportService2010::ParameterValue ^> ^ Values, cli::array <ReportService2010::DataSourceCredentials ^> ^ Credentials);

[System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/GetItemParameters", ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped, RequestNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", ResponseNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", Use=System.Web.Services.Description.SoapBindingUse.Literal)]
[System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")]
[System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)]
public ReportService2010.ItemParameter[] GetItemParameters (string ItemPath, string HistoryID, bool ForRendering, ReportService2010.ParameterValue[] Values, ReportService2010.DataSourceCredentials[] Credentials);

[<System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/GetItemParameters", ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped, RequestNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", ResponseNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", Use=System.Web.Services.Description.SoapBindingUse.Literal)>]
[<System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")>]
[<System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)>]
member this.GetItemParameters : string * string * bool * ReportService2010.ParameterValue[] * ReportService2010.DataSourceCredentials[] -> ReportService2010.ItemParameter[]

Public Function GetItemParameters (ItemPath As String, HistoryID As String, ForRendering As Boolean, Values As ParameterValue(), Credentials As DataSourceCredentials()) As ItemParameter()

Parametri

ItemPath: String

URL completo dell'elemento, inclusi il nome file e, in modalità SharePoint, l'estensione.

HistoryID: String

ID dello snapshot della cronologia dell'elemento. Impostare il ForRendering parametro su un valore di per recuperare le proprietà dei true parametri per uno snapshot della cronologia degli elementi. Impostare il valore su null (Nothing in Visual Basic) se si recuperano parametri per un elemento che non rappresenta uno snapshot della cronologia dell'elemento.

ForRendering: Boolean

Espressione Boolean che indica come devono essere utilizzati i valori del parametro. Se impostata sul valore true, le proprietà restituite dei parametri si basano sui dati dei parametri utilizzati durante l'esecuzione dell'elemento.

Values: ParameterValue[]

Valori dei parametri (oggettiParameterValue ) che possono essere convalidati rispetto ai parametri di un elemento gestito dal server di report.

Credentials: DataSourceCredentials[]

Credenziali per l'origine dati (oggettiDataSourceCredentials) che possono essere utilizzate per convalidare i parametri delle query.

Restituisce

ItemParameter[]

Matrice di oggetti ItemParameter in cui sono elencati i parametri per l'elemento.

Attributi: SoapDocumentMethodAttribute SoapHeaderAttribute

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 GetItemParameters metodo per recuperare un elenco di metadati dei parametri per un report e quindi viene visualizzato il nome di ogni parametro:

Imports System  
Imports System.Web.Services.Protocols  

Class Sample  
   Public Shared Sub Main()  
      Dim rs As New ReportingService2010()  
      rs.Credentials = System.Net.CredentialCache.DefaultCredentials  

      Dim report As String = "/SampleReports/Employee Sales Summary"  
      Dim forRendering As Boolean = False  
      Dim historyID As String = Nothing  
      Dim values As ParameterValue() = Nothing  
      Dim credentials As DataSourceCredentials() = Nothing  
      Dim parameters As ItemParameter() = Nothing  

      Try  
         parameters = rs.GetItemParameters(report, historyID, forRendering, values, credentials)  

         If Not (parameters Is Nothing) Then  
            Dim rp As ItemParameter  
            For Each rp In parameters  
               Console.WriteLine("Name: {0}", rp.Name)  
            Next rp  
         End If  

      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()  
   {  
      ReportingService2010 rs = new ReportingService2010();  
      rs.Credentials = System.Net.CredentialCache.DefaultCredentials;  

      string report = "/SampleReports/Employee Sales Summary";  
      bool forRendering = false;  
      string historyID = null;  
      ParameterValue[] values = null;  
      DataSourceCredentials[] credentials = null;  
      ItemParameter[] parameters = null;  

      try  
      {  
         parameters = rs.GetItemParameters(report, historyID, forRendering, values, credentials);  

         if (parameters != null)  
         {  
            foreach (ItemParameter rp in parameters)  
            {  
               Console.WriteLine("Name: {0}", rp.Name);  
            }  
         }  
      }  

      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.


Utilizzo intestazione SOAP	(In) TrustedUserHeaderValue (Out) ServerInfoHeaderValue
Autorizzazioni necessarie in modalità nativa	ReadProperties
Autorizzazioni necessarie per la modalità SharePoint	<xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems>

Se l'impostazione di esecuzione per l'elemento è Snapshot, i metadati dei parametri restituiti sono i dati usati quando è stato creato lo snapshot della cronologia degli elementi. Se l'impostazione di esecuzione per l'elemento è Live, i metadati dei parametri restituiti rappresentano i dati dei parametri associati all'elemento specificato.

Se si specifica un valore per il HistoryID parametro e si imposta il ForRendering valoretrue del parametro su, i metadati dei parametri restituiti rappresentano i dati dei parametri usati quando è stato creato lo snapshot della cronologia degli elementi. Il valore specificato per HistoryID viene ignorato se ForRendering è impostato su false. Se ForRendering è false, i metadati dei parametri restituiti rappresentano i dati dei parametri attualmente associati all'elemento specificato.

Se i valori dei parametri sono basati su una query e si è interessati a restituire l'elenco di valori validi dei parametri basati su query, impostato ForRendering su true. Inoltre, per i parametri basati su query, è necessario passare tutte le informazioni sulle credenziali necessarie per restituire i parametri di query.

Quando si usa il GetItemParameters metodo per convalidare i parametri, è necessario il Values parametro.

Se i parametri non esistono per l'elemento specificato, viene restituita una matrice vuota ItemParameter .

Si applica a