ReportingService2006.GetReportParameters Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Devuelve las propiedades de los parámetros de informe para un informe especificado. El método GetReportParameters(String, String, ParameterValue[], DataSourceCredentials[]) también se puede usar para validar los valores de parámetro con los parámetros de un informe especificado.
public:
cli::array <ReportService2006::ReportParameter ^> ^ GetReportParameters(System::String ^ Report, System::String ^ HistoryID, cli::array <ReportService2006::ParameterValue ^> ^ Values, cli::array <ReportService2006::DataSourceCredentials ^> ^ Credentials);
public ReportService2006.ReportParameter[] GetReportParameters (string Report, string HistoryID, ReportService2006.ParameterValue[] Values, ReportService2006.DataSourceCredentials[] Credentials);
member this.GetReportParameters : string * string * ReportService2006.ParameterValue[] * ReportService2006.DataSourceCredentials[] -> ReportService2006.ReportParameter[]
Public Function GetReportParameters (Report As String, HistoryID As String, Values As ParameterValue(), Credentials As DataSourceCredentials()) As ReportParameter()
Parámetros
- Report
- String
Dirección URL completa del informe, incluidos el nombre y la extensión de nombre de archivo .rdl.
- HistoryID
- String
Identificador de la instantánea del historial de informes. Establezca el ForRendering
parámetro en un valor de para recuperar las propiedades de true
parámetro de una instantánea del historial de informes. Establezca el valor en null
(Nothing
en Visual Basic) si va a recuperar los parámetros para un informe que no sea una instantánea del historial de informes.
- Values
- ParameterValue[]
Valores de los parámetros (objetosParameterValue ) que se pueden validar con los parámetros de un informe.
- Credentials
- DataSourceCredentials[]
Credenciales del origen de datos (objetosDataSourceCredentials) que se pueden utilizar para validar los parámetros de la consulta.
Devoluciones
Matriz de objetos ReportParameter que enumeran los parámetros para el informe.
Ejemplos
using System;
using System.Collections.Generic;
using System.IO;
using System.Text;
using System.Web;
using System.Web.Services;
using System.Web.Services.Protocols;
class Sample
{
static void Main(string[] args)
{
ReportingService2006 rs = new ReportingService2006();
rs.Url = "http://<Server Name>/_vti_bin/ReportServer/" +
"ReportService2006.asmx";
rs.Credentials =
System.Net.CredentialCache.DefaultCredentials;
string report = "http://<Server Name>/Docs/Documents" +
"/AdventureWorks Sample Reports/" +
"Employee Sales Summary.rdl";
string historyID = null;
ParameterValue[] values = null;
DataSourceCredentials[] credentials = null;
ReportParameter[] parameters = null;
try
{
parameters = rs.GetReportParameters(report, historyID,
values, credentials);
if (parameters != null)
{
foreach (ReportParameter rp in parameters)
{
Console.WriteLine("Name: {0}", rp.Name);
}
}
}
catch (SoapException e)
{
Console.WriteLine(e.Detail.InnerXml.ToString());
}
}
}
Imports System
Imports System.IO
Imports System.Text
Imports System.Web.Services
Imports System.Web.Services.Protocols
Class Sample
Public Shared Sub Main()
Dim rs As New ReportingService2006()
rs.Url = "http://<Server Name>/_vti_bin/" + _
"ReportServer/ReportService2006.asmx"
rs.Credentials = _
System.Net.CredentialCache.DefaultCredentials
Dim report As String = "http://<Server Name>" + _
"/Docs/Documents/AdventureWorks Sample Reports" + _
"/Employee Sales Summary.rdl"
Dim historyID As String = Nothing
Dim values As ParameterValue() = Nothing
Dim credentials As DataSourceCredentials() = Nothing
Dim parameters As ReportParameter() = Nothing
Try
parameters = rs.GetReportParameters(report, historyID, _
values, credentials)
If Not (parameters Is Nothing) Then
Dim rp As ReportParameter
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
End Class
Comentarios
En la siguiente tabla se muestra la información de encabezado y de permisos de esta operación.
Encabezados SOAP | (In) TrustedUserHeaderValue (Out) ServerInfoHeaderValue |
Permisos necesarios | <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems> |
Si la configuración de ejecución del informe es Snapshot
, los metadatos de parámetro que se devuelven son los datos que se usaron cuando se creó la instantánea del historial de informes. Si la configuración de ejecución del informe es Live
, los metadatos de parámetro devueltos representan los datos de parámetro asociados al informe especificado.
Si proporciona un valor para el HistoryID
parámetro y establece el valor true
del ForRendering
parámetro en , los metadatos de parámetro devueltos representan los datos de parámetro que se usaron cuando se creó la instantánea del historial de informes. El valor proporcionado para HistoryID
se omite si ForRendering
se establece en false
. Si ForRendering
es false
, los metadatos de parámetro devueltos representan los datos de parámetro que están asociados actualmente al informe especificado.
Si los valores de parámetros se basan en una consulta y está interesado en devolver la lista de valores válidos de los parámetros basados en consultas, establezca en ForRendering
true
. Además, para los parámetros basados en consultas, debe pasar toda la información de credenciales necesaria para devolver los parámetros de consulta.
Cuando se usa el GetReportParameters método para validar parámetros, se requiere el Values
parámetro .
Si los parámetros de informe no existen para el informe determinado, se devuelve una matriz vacía ReportParameter .