Metoda ReportingService2010.GetItemParameters
Zwraca wartość określonej właściwości parametru element.Tej metoda można również sprawdzić poprawności parametru wartości parametrów dla określonego element.
Przestrzeń nazw: ReportService2010
Zestaw: ReportService2010 (w ReportService2010.dll)
Składnia
'Deklaracja
<SoapHeaderAttribute("TrustedUserHeaderValue")> _
<SoapHeaderAttribute("ServerInfoHeaderValue", Direction := SoapHeaderDirection.Out)> _
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/GetItemParameters", RequestNamespace := "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", _
ResponseNamespace := "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", _
Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
Public Function GetItemParameters ( _
ItemPath As String, _
HistoryID As String, _
ForRendering As Boolean, _
Values As ParameterValue(), _
Credentials As DataSourceCredentials() _
) As ItemParameter()
'Użycie
Dim instance As ReportingService2010
Dim ItemPath As String
Dim HistoryID As String
Dim ForRendering As Boolean
Dim Values As ParameterValue()
Dim Credentials As DataSourceCredentials()
Dim returnValue As ItemParameter()
returnValue = instance.GetItemParameters(ItemPath, _
HistoryID, ForRendering, Values, _
Credentials)
[SoapHeaderAttribute("TrustedUserHeaderValue")]
[SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)]
[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/GetItemParameters", RequestNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",
ResponseNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",
Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
public ItemParameter[] GetItemParameters(
string ItemPath,
string HistoryID,
bool ForRendering,
ParameterValue[] Values,
DataSourceCredentials[] Credentials
)
[SoapHeaderAttribute(L"TrustedUserHeaderValue")]
[SoapHeaderAttribute(L"ServerInfoHeaderValue", Direction = SoapHeaderDirection::Out)]
[SoapDocumentMethodAttribute(L"https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/GetItemParameters", RequestNamespace = L"https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",
ResponseNamespace = L"https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",
Use = SoapBindingUse::Literal, ParameterStyle = SoapParameterStyle::Wrapped)]
public:
array<ItemParameter^>^ GetItemParameters(
String^ ItemPath,
String^ HistoryID,
bool ForRendering,
array<ParameterValue^>^ Values,
array<DataSourceCredentials^>^ Credentials
)
[<SoapHeaderAttribute("TrustedUserHeaderValue")>]
[<SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)>]
[<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/GetItemParameters", RequestNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",
ResponseNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",
Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)>]
member GetItemParameters :
ItemPath:string *
HistoryID:string *
ForRendering:bool *
Values:ParameterValue[] *
Credentials:DataSourceCredentials[] -> ItemParameter[]
public function GetItemParameters(
ItemPath : String,
HistoryID : String,
ForRendering : boolean,
Values : ParameterValue[],
Credentials : DataSourceCredentials[]
) : ItemParameter[]
Parametry
- ItemPath
Typ: System.String
W pełni kwalifikowana URL element, łącznie z nazwą pliku i w trybie SharePoint rozszerzenia.
- HistoryID
Typ: System.String
Identyfikator element migawka historia.Ustaw ForRendering parametru na wartość true do pobierania właściwości parametru dla element migawka historia.Ustaw wartość na nullodwołanie o wartości null (Nothing w języku Visual Basic) (nic w języku Visual Basic), jeśli są pobieranie parametrów elementu nie jest element migawka historia.
- ForRendering
Typ: System.Boolean
A wartość logiczna wyrażenie, która wskazuje, jak są używane wartości parametrów.Jeśli zestaw na wartość true, właściwości parametru, zwracane są oparte na danych parametru, używany podczas wykonywania element.
- Values
Typ: array<ReportService2010.ParameterValue[]
Wartości parametrów (ParameterValue obiektów), mogą być sprawdzone przed parametrów element, który jest zarządzany przez serwer raportów.
- Credentials
Typ: array<ReportService2010.DataSourceCredentials[]
Dane źródło poświadczenia (DataSourceCredentials obiektów), może służyć do sprawdzania poprawności parametrów kwerendy.
Wartość zwracana
Typ: array<ReportService2010.ItemParameter[]
Tablica ItemParameter obiektów, które zawiera listę parametrów dla element.
Uwagi
W poniższej tabela przedstawiono informacje nagłówka i uprawnienia na tej operacji.
Użycie nagłówek protokołu SOAP |
(Ruch wychodzący)ServerInfoHeaderValue |
Tryb macierzysty wymagane uprawnienia |
|
Tryb programu SharePoint wymagane uprawnienia |
ViewListItems() |
Jeśli ustawienie realizacji dla towaru jest migawka, metadane parametrów, zwracana jest używany podczas tworzenia migawka historia element danych.Jeśli ustawienie wykonanie element jest Live, metadane parametrów zwracane reprezentuje dane parametr, który jest skojarzony z określonym element.
Jeśli wartość dla HistoryID parametr i zestaw ForRendering wartość parametru true, metadane parametrów zwracane reprezentuje dane parametr użytej do utworzenia migawka historia element.Wartość dostarczonych do HistoryID jest ignorowane, jeśli ForRendering jest zestaw do false.Jeśli ForRendering jest false, metadane parametrów zwracane reprezentuje dane parametr, która jest aktualnie skojarzona z określonym elementem.
Jeśli wartości parametrów są oparte na kwerendzie i interesuje Cię przekazujących dane oparte na kwerendzie parametrów lista prawidłowych wartości zestaw ForRendering do true.Ponadto oparte na kwerendzie parametrów musi upłynąć w wszystkie wymagane parametry kwerendy zwraca informacje poświadczeń.
Podczas korzystania z GetItemParameters metoda sprawdzania poprawności parametrów, Values parametr jest wymagany.
Jeżeli parametry nie istnieją dla danego element pustego ItemParameter zwracana jest tablica.
Przykłady
Aby skompilować ten przykład kodu, należy odwołać WSDL usług Reporting i przywozu niektórych obszarów nazw.Aby uzyskać więcej informacji, zobacz temat Compiling and Running Code Examples.Następujący kod w przykładzie wykorzystano GetItemParameters metoda, aby pobrać listę metadane parametrów raportu, a następnie wyświetla nazwę każdego parametru:
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());
}
}
}