ReportingService2010.PrepareQuery Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Returns a dataset that contains the fields retrieved by the delivery query for a data-driven subscription.
public:
ReportService2010::DataSetDefinition ^ PrepareQuery(ReportService2010::DataSource ^ DataSource, ReportService2010::DataSetDefinition ^ DataSet, [Runtime::InteropServices::Out] bool % Changed, [Runtime::InteropServices::Out] cli::array <System::String ^> ^ % ParameterNames);
[System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/PrepareQuery", 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.DataSetDefinition PrepareQuery (ReportService2010.DataSource DataSource, ReportService2010.DataSetDefinition DataSet, out bool Changed, out string[] ParameterNames);
[<System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/PrepareQuery", 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.PrepareQuery : ReportService2010.DataSource * ReportService2010.DataSetDefinition * bool * String[] -> ReportService2010.DataSetDefinition
Public Function PrepareQuery (DataSource As DataSource, DataSet As DataSetDefinition, ByRef Changed As Boolean, ByRef ParameterNames As String()) As DataSetDefinition
Parameters
- DataSource
- DataSource
The data source for the delivery query. This can be a shared data source or a model.
- DataSet
- DataSetDefinition
The dataset that contains the delivery query and fields for a data-driven subscription.
- Changed
- Boolean
[out] A Boolean
value that indicates whether the dataset that was passed to the method differs from the one returned by the method. Use this property to determine whether the input dataset differs from the output dataset.
- ParameterNames
- 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.
Returns
A DataSetDefinition object that contains the fields and the delivery query that are retrieved from the given data source.
- Attributes
Remarks
The table below shows header and permissions information on this operation.
SOAP Header Usage | (In) TrustedUserHeaderValue (Out) ServerInfoHeaderValue |
Native Mode Required Permissions | Depends on the item type: - DataSource : ReadProperties- Model : ReadProperties |
SharePoint Mode Required Permissions | <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems> on DataSource |