Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

ReportingService2005.PrepareQuery Method

Returns a dataset containing the fields retrieved by the delivery query for a data-driven subscription.

Namespace:  ReportService2005
Assembly:  ReportService2005 (in ReportService2005.dll)

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

Parameters

DataSource
Type: ReportService2005.DataSource
The data source for the delivery query.
DataSet
Type: ReportService2005.DataSetDefinition
The dataset containing the delivery query and fields for a data-driven subscription.
Changed
Type: Boolean
[out] A Boolean value that indicates whether the dataset that was passed to the method is different from the one returned by the method. Use this property to determine whether the input dataset is different from the output dataset.
ParameterNames
Type: String[]
[out] The names of the query parameters used in the underlying semantic query. This out parameter is only used when the DataSource references a model.

Return Value

Type: ReportService2005.DataSetDefinition
A DataSetDefinition object that contains the fields and the delivery query that are retrieved from the given data source.

The table below shows header and permissions information on this operation.

SOAP Headers

(In) BatchHeaderValue

(Out) ServerInfoHeaderValue

Required Permissions

Depends on the item type:

Pass the DataSetDefinition object that is returned by the PrepareQuery method as input to the CreateDataDrivenSubscription and SetDataDrivenSubscriptionProperties methods.

The delivery query returns a set of fields that can be mapped to report parameter values and delivery extension settings for data-driven subscriptions. Each row in the result set contains values for a single recipient, such as an e-mail address to which the report is delivered.

The delivery query must be valid for one of the data processing extensions that are installed on the report server. For more information, see Data Processing Extensions Overview.

Community Additions

Show:
© 2015 Microsoft