ReportExecutionService.Render2 メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
特定のレポートを処理し、指定された形式でレンダリングします。
public:
cli::array <System::Byte> ^ Render2(System::String ^ Format, System::String ^ DeviceInfo, ReportExecution2005::PageCountMode PaginationMode, [Runtime::InteropServices::Out] System::String ^ % Extension, [Runtime::InteropServices::Out] System::String ^ % MimeType, [Runtime::InteropServices::Out] System::String ^ % Encoding, [Runtime::InteropServices::Out] cli::array <ReportExecution2005::Warning ^> ^ % Warnings, [Runtime::InteropServices::Out] cli::array <System::String ^> ^ % StreamIds);
public byte[] Render2(string Format, string DeviceInfo, ReportExecution2005.PageCountMode PaginationMode, out string Extension, out string MimeType, out string Encoding, out ReportExecution2005.Warning[] Warnings, out string[] StreamIds);
member this.Render2 : string * string * ReportExecution2005.PageCountMode * string * string * string * Warning[] * String[] -> byte[]
Public Function Render2 (Format As String, DeviceInfo As String, PaginationMode As PageCountMode, ByRef Extension As String, ByRef MimeType As String, ByRef Encoding As String, ByRef Warnings As Warning(), ByRef StreamIds As String()) As Byte()
パラメーター
- Format
- String
報告書を提出する形式について。 この引数はレンダリング拡張に対応します。 対応している拡張には、XML、NULL、CSV、IMAGE、PDF、HTML4.0、HTML3.2、MHTML、EXCEL、Wordなどがあります。 サポートされている拡張のリストは、 ListRenderingExtensions() メソッドを呼び出すことで取得できます。
- DeviceInfo
- String
Formatパラメータで指定されたレンダリング拡張に必要なデバイス固有のコンテンツを含むXML文字列です。 DeviceInfoの設定は、DeviceInfoのXML要素の内部要素として渡されなければなりません。 特定の出力フォーマットにおけるデバイス情報設定の詳細については、「 Passing Device Information Settings to Rendering Extensions」をご覧ください。
- PaginationMode
- PageCountMode
報告書の処理方法。
- Extension
- String
[アウト]出力ストリームに対応するファイル拡張子。
- MimeType
- String
[アウト]レンダリングされたレポートのMIMEタイプです。
- Encoding
- String
[アウト]レポートサーバーがレポートの内容をレンダリングする際に使われるエンコーディング。
- StreamIds
- String[]
[アウト]ストリーム識別子です。 これらのIDは RenderStream(String, String, String, String, String) メソッドに渡されます。 これらのツールを使って、特定のレポートに関連付けられた外部リソース(画像など)をレンダリングできます。
返品
指定された形式の レポートのバイト[] 配列です。
注釈
以下の表は、この操作のヘッダーおよび権限情報を示しています。
| SOAPヘッダーの使用 | (イン) TrustedUserHeaderValue (イン) ExecutionHeaderValue (アウト) ServerInfoHeaderValue |
| ネイティブモードの必要権限 | メインレポートおよびすべてのサブレポートでは、 ReadProperties AND ExecuteAndView |
| SharePointモードの必要権限 | メインレポートおよびすべてのサブレポートについて: <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems> |
Render2 ExecutionInfo2ヘッダーで特定されたレポート実行に関連する処理済みレポートをレンダリングします。 セッションスナップショットが存在しない場合、このメソッドは(すべての認証情報およびパラメータ要件が満たされている場合)レポートを実行し、新しいセッションスナップショットが作成されます。 クエリ以外のパラメータ値が変更されてレポートを再処理する必要がある場合、スナップショットは再処理されます。
実行オプションがキャッシュまたは実行スナップショットに設定されている場合、 Render2 の呼び出しは既存のスナップショットを使用することがあります。
レポートがキャッシュに設定されていて、提供されたパラメータ値と認証情報が一致している場合、スナップショットのキャッシュコピーが実際にレポートを処理する代わりに読み込まれることがあります。
認証情報やパラメータ要件が満たされていない場合、この方法はエラーを返します。
レンダリング拡張が複数ページの指定をサポートしている場合、その後の Render2 呼び出しでレポートの追加ページを取得することができます。
Renderメソッドの制限は、出力がストリーミングできないため、ファイル全体がメモリ内に保管されていることです。
実行ライフサイクルについては「 実行状態の識別 」をご覧ください。レポートの読み込みとレンダリングに必要な手順の説明も含まれています。