ReportingService2005.PrepareQuery 方法

定义

命名空间:

ReportService2005

程序集:

ReportService2005.dll

返回一个数据集，其中包含由数据驱动订阅的传递查询检索的字段。

public:
 ReportService2005::DataSetDefinition ^ PrepareQuery(ReportService2005::DataSource ^ DataSource, ReportService2005::DataSetDefinition ^ DataSet, [Runtime::InteropServices::Out] bool % Changed, [Runtime::InteropServices::Out] cli::array <System::String ^> ^ % ParameterNames);

public ReportService2005.DataSetDefinition PrepareQuery (ReportService2005.DataSource DataSource, ReportService2005.DataSetDefinition DataSet, out bool Changed, out string[] ParameterNames);

member this.PrepareQuery : ReportService2005.DataSource * ReportService2005.DataSetDefinition * bool * String[] -> ReportService2005.DataSetDefinition

Public Function PrepareQuery (DataSource As DataSource, DataSet As DataSetDefinition, ByRef Changed As Boolean, ByRef ParameterNames As String()) As DataSetDefinition

参数

DataSource

DataSource

传递查询的数据源。

DataSet

DataSetDefinition

包含数据驱动订阅的传递查询和字段的数据集。

Changed

Boolean

[out] 一个Boolean值，该值指示传递到该方法的数据集与该方法返回的数据集是否不同。 使用此属性可确定输入数据集是否不同于输出数据集。

ParameterNames

String[]

[out] 在基础语义查询中使用的查询参数的名称。 仅当 引用模型时， DataSource 才使用此 out 参数。

返回

DataSetDefinition

一个 DataSetDefinition 对象，该对象包含从给定数据源中检索的字段和传递查询。

注解

下表显示了有关此操作的标头和权限信息。

SOAP 标头	(In) BatchHeaderValue (Out) ServerInfoHeaderValue
所需的权限	取决于项类型： - DataSource: ReadProperties - Model: ReadProperties

将 DataSetDefinition 方法返回 PrepareQuery 的对象作为输入传递给 CreateDataDrivenSubscription 和 SetDataDrivenSubscriptionProperties 方法。

传递查询返回一组字段，这些字段可映射到数据驱动订阅的报表参数值和传递扩展插件设置。 结果集中的每一行都包含单个收件人的值，例如向其传递报表的电子邮件地址。

传递查询必须对安装在报表服务器上的某个数据处理扩展插件有效。 有关详细信息，请参阅 数据处理扩展插件概述。