言語

ReportExecutionService.Render2 メソッド

定義

特定のレポートを処理し、指定された形式でレンダリングします。

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

[アウト]レポートサーバーがレポートの内容をレンダリングする際に使われるエンコーディング。

Warnings
Warning[]

[アウト]レポート処理中に発生した警告を表す Warning オブジェクトの配列です。

StreamIds
String[]

[アウト]ストリーム識別子です。 これらのIDは RenderStream(String, String, String, String, String) メソッドに渡されます。 これらのツールを使って、特定のレポートに関連付けられた外部リソース(画像など)をレンダリングできます。

返品

Byte[]

指定された形式の レポートのバイト[] 配列です。

注釈

以下の表は、この操作のヘッダーおよび権限情報を示しています。

SOAPヘッダーの使用 (イン) TrustedUserHeaderValue

(イン) ExecutionHeaderValue

(アウト) ServerInfoHeaderValue
ネイティブモードの必要権限 メインレポートおよびすべてのサブレポートでは、 ReadProperties AND ExecuteAndView
SharePointモードの必要権限 メインレポートおよびすべてのサブレポートについて: <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems>

Render2 ExecutionInfo2ヘッダーで特定されたレポート実行に関連する処理済みレポートをレンダリングします。 セッションスナップショットが存在しない場合、このメソッドは(すべての認証情報およびパラメータ要件が満たされている場合)レポートを実行し、新しいセッションスナップショットが作成されます。 クエリ以外のパラメータ値が変更されてレポートを再処理する必要がある場合、スナップショットは再処理されます。

実行オプションがキャッシュまたは実行スナップショットに設定されている場合、 Render2 の呼び出しは既存のスナップショットを使用することがあります。

レポートがキャッシュに設定されていて、提供されたパラメータ値と認証情報が一致している場合、スナップショットのキャッシュコピーが実際にレポートを処理する代わりに読み込まれることがあります。

認証情報やパラメータ要件が満たされていない場合、この方法はエラーを返します。

レンダリング拡張が複数ページの指定をサポートしている場合、その後の Render2 呼び出しでレポートの追加ページを取得することができます。

Renderメソッドの制限は、出力がストリーミングできないため、ファイル全体がメモリ内に保管されていることです。

実行ライフサイクルについては「 実行状態の識別 」をご覧ください。レポートの読み込みとレンダリングに必要な手順の説明も含まれています。

適用対象