ReportingService2010.GetItemParameters Metode

Referensi

Definisi

Ruang nama:: ReportService2010

Rakitan:: ReportService2010.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mengembalikan properti parameter untuk item tertentu. Metode ini juga dapat digunakan untuk memvalidasi nilai parameter terhadap parameter untuk item tertentu.

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

URL item yang sepenuhnya memenuhi syarat termasuk nama file dan, dalam mode SharePoint, ekstensi.

HistoryID: String

ID rekam jepret riwayat item. Atur ForRendering parameter ke nilai true untuk mengambil properti parameter untuk rekam jepret riwayat item. Atur nilai ke null (Nothing di Visual Basic) jika Anda mengambil parameter untuk item yang bukan rekam jepret riwayat item.

ForRendering: Boolean

Ekspresi Boolean yang menunjukkan bagaimana nilai parameter akan digunakan. Jika diatur ke nilai true, properti parameter yang dikembalikan didasarkan pada data parameter yang digunakan selama eksekusi item.

Values: ParameterValue[]

Nilai parameter (ParameterValue objek) yang dapat divalidasi terhadap parameter item yang dikelola oleh server laporan.

Credentials: DataSourceCredentials[]

Kredensial sumber data (DataSourceCredentials objek) yang dapat digunakan untuk memvalidasi parameter kueri.

Mengembalikan

ItemParameter[]

Array ItemParameter objek yang mencantumkan parameter untuk item.

Atribut: SoapDocumentMethodAttribute SoapHeaderAttribute

Contoh

Untuk mengkompilasi contoh kode ini, Anda harus mereferensikan Reporting Services WSDL dan mengimpor namespace tertentu. Untuk informasi selengkapnya, lihat Mengkompilasi dan Menjalankan Contoh Kode. Contoh kode berikut menggunakan GetItemParameters metode untuk mengambil daftar metadata parameter untuk laporan lalu menampilkan nama setiap parameter:

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

Keterangan

Tabel di bawah ini memperlihatkan informasi header dan izin pada operasi ini.


Penggunaan Header SOAP	(Dalam) TrustedUserHeaderValue (Keluar) ServerInfoHeaderValue
Izin Yang Diperlukan Mode Asli	ReadProperties
Izin yang Diperlukan Mode SharePoint	<xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems>

Jika pengaturan eksekusi untuk item adalah Snapshot, metadata parameter yang dikembalikan adalah data yang digunakan saat rekam jepret riwayat item dibuat. Jika pengaturan eksekusi untuk item adalah Live, metadata parameter yang dikembalikan mewakili data parameter yang terkait dengan item yang ditentukan.

Jika Anda memberikan nilai untuk HistoryID parameter dan mengatur ForRendering nilai parameter ketrue, metadata parameter yang dikembalikan mewakili data parameter yang digunakan saat rekam jepret riwayat item dibuat. Nilai yang disediakan untuk HistoryID diabaikan jika ForRendering diatur ke false. Jika ForRendering adalah false, metadata parameter yang dikembalikan mewakili data parameter yang saat ini terkait dengan item yang ditentukan.

Jika ada nilai parameter yang didasarkan pada kueri dan Anda tertarik untuk mengembalikan daftar nilai valid parameter berbasis kueri, atur ForRendering ke true. Selain itu, untuk parameter berbasis kueri, Anda harus meneruskan semua informasi kredensial yang diperlukan untuk mengembalikan parameter kueri.

Saat menggunakan GetItemParameters metode untuk memvalidasi parameter, Values parameter diperlukan.

Jika parameter tidak ada untuk item yang diberikan, array kosong ItemParameter dikembalikan.

Berlaku untuk

Bagikan melalui