ReportingService2005.PrepareQuery 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
回傳包含資料驅動訂閱中由傳遞查詢取得欄位的資料集。
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.DataSetDefinitionPublic Function PrepareQuery (DataSource As DataSource, DataSet As DataSetDefinition, ByRef Changed As Boolean, ByRef ParameterNames As String()) As DataSetDefinition參數
- DataSource
- DataSource
交付查詢的資料來源。
- DataSet
- DataSetDefinition
包含資料驅動訂閱的傳遞查詢與欄位的資料集。
- Changed
- Boolean
[出]一個 Boolean 表示傳遞給該方法的資料集是否與該方法回傳的資料集不同的值。 利用此特性判斷輸入資料集是否與輸出資料集不同。
- ParameterNames
- String[]
[出]底層語意查詢中使用的查詢參數名稱。 此 out 參數僅在參考 DataSource 模型時使用。
傳回
一個 DataSetDefinition 包含從指定資料來源擷取的欄位與傳遞查詢的物件。
備註
下表顯示此操作的標頭與權限資訊。
| SOAP 標頭 | （在） BatchHeaderValue （出局） ServerInfoHeaderValue |
| 必要權限 | 這取決於物品類型： - DataSource: ReadProperties- Model: ReadProperties |
將 DataSetDefinition 方法回傳 PrepareQuery 的物件作為輸入傳遞給 CreateDataDrivenSubscription and SetDataDrivenSubscriptionProperties 方法。
傳遞查詢會回傳一組欄位，這些欄位可映射為資料驅動訂閱的報表參數值及傳遞擴展設定。 結果集的每一列都包含單一收件人的值，例如報告送達的電子郵件地址。
交付查詢必須是對報告伺服器上安裝的資料處理擴充功能有效的。 欲了解更多資訊，請參閱 資料處理擴充概述。