Freigeben über


ReportingService2010.GetItemParameters Methode

Definition

Gibt Parametereigenschaften für ein angegebenes Element an. Diese Methode kann auch verwendet werden, um Parameterwerte anhand von Parametern für ein angegebenes Element zu überprüfen.

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()

Parameter

ItemPath
String

Die vollqualifizierte URL des Elements einschließlich des Dateinamens und (im SharePoint-Modus) der Erweiterung.

HistoryID
String

Die ID der Elementverlaufs-Momentaufnahme. Legen Sie den ForRendering Parameter auf einen Wert von true fest, um Parametereigenschaften für einen Elementverlauf Momentaufnahme abzurufen. Legen Sie den Wert auf null (Nothing in Visual Basic) fest, wenn Sie Parameter für ein Element abrufen, bei dem es sich nicht um eine Elementverlaufs-Momentaufnahme handelt.

ForRendering
Boolean

Ein Boolean-Ausdruck, der angibt, wie die Parameterwerte verwendet werden sollen. Wenn true festgelegt wurde, basieren die zurückgegebenen Parametereigenschaften auf den Parameterdaten, die während der Ausführung des Elements verwendet wurden.

Values
ParameterValue[]

Die Parameterwerte (ParameterValue-Objekte), die für die Parameter eines Elements, das vom Berichtsserver verwaltet wird, validiert werden können.

Credentials
DataSourceCredentials[]

Die Anmeldeinformationen für die Datenquelle (DataSourceCredentials-Objekte), mit denen Abfrageparameter validiert werden können.

Gibt zurück

Ein Array von ItemParameter-Objekten, das die Parameter für das Element aufführt.

Attribute

Beispiele

Um dieses Codebeispiel zu kompilieren, müssen Sie auf die Reporting Services WSDL verweisen und bestimmte Namespaces importieren. Weitere Informationen finden Sie unter Kompilieren und Ausführen von Codebeispielen. Im folgenden Codebeispiel wird die GetItemParameters -Methode verwendet, um eine Liste von Parametermetadaten für einen Bericht abzurufen und dann den Namen der einzelnen Parameter anzuzeigen:

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());   
      }  
   }  
}  

Hinweise

In der folgenden Tabelle werden Header- und Berechtigungsinformationen zu diesem Vorgang dargestellt.

SOAP-Headerverwendung (In) TrustedUserHeaderValue

(Out) ServerInfoHeaderValue
Erforderliche Berechtigungen im einheitlichen Modus ReadProperties
Erforderliche Berechtigungen im SharePoint-Modus <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems>

Wenn die Ausführungseinstellung für das Element lautetSnapshot, sind die zurückgegebenen Parametermetadaten die Daten, die beim Erstellen des Elementverlaufs Momentaufnahme verwendet wurden. Wenn die Ausführungseinstellung für das Element lautet Live, stellen die zurückgegebenen Parametermetadaten die Parameterdaten dar, die dem angegebenen Element zugeordnet sind.

Wenn Sie einen Wert für den HistoryID Parameter angeben und den ForRendering Parameterwert auftrue festlegen, stellen die zurückgegebenen Parametermetadaten die Parameterdaten dar, die beim Erstellen des Elementverlaufs Momentaufnahme verwendet wurden. Der für HistoryID angegebene Wert wird ignoriert, wenn ForRendering auf falsefestgelegt ist. Wenn ForRendering ist false, stellen die zurückgegebenen Parametermetadaten die Parameterdaten dar, die derzeit dem angegebenen Element zugeordnet sind.

Wenn Parameterwerte auf einer Abfrage basieren und Sie daran interessiert sind, die Liste der gültigen Werte der abfragebasierten Parameter zurückzugeben, legen Sie auf truefestForRendering. Darüber hinaus müssen Sie für abfragebasierte Parameter alle Anmeldeinformationen übergeben, die zum Zurückgeben der Abfrageparameter erforderlich sind.

Wenn Sie die -Methode zum Überprüfen von GetItemParameters Parametern verwenden, ist der Values Parameter erforderlich.

Wenn für das angegebene Element keine Parameter vorhanden sind, wird ein leeres ItemParameter Array zurückgegeben.

Gilt für: