CreateAndRegisterStream 代理人
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ストリームを作成および登録し、レポートの表示先のストリームを取得するためにレポート サーバーによって呼び出されます。
public delegate System::IO::Stream ^ CreateAndRegisterStream(System::String ^ name, System::String ^ extension, Encoding ^ encoding, System::String ^ mimeType, bool willSeek, StreamOper operation);public delegate System.IO.Stream CreateAndRegisterStream(string name, string extension, Encoding encoding, string mimeType, bool willSeek, StreamOper operation);type CreateAndRegisterStream = delegate of string * string * Encoding * string * bool * StreamOper -> StreamPublic Delegate Function CreateAndRegisterStream(name As String, extension As String, encoding As Encoding, mimeType As String, willSeek As Boolean, operation As StreamOper) As Stream パラメーター
- name
- String
ストリームの名前です。 要求される最初のストリームは、たとえば HTML 表示での HTML や、ページ単位の表示での先頭ページなどの、レポートの本文である必要があります。 名前は、レポート内で一意である必要があります。使用できる文字は、0 ～ 9、a ～ z (小文字のみ)、およびアンダースコア (_) だけです。 アンダースコアは、名前の最初の文字としては使用できません。
- extension
- String
ストリームのファイル拡張子です。
- encoding
- Encoding
ストリームの文字エンコーディング。 ストリームに文字が含まれない場合には、NULL を指定することができます。
- mimeType
- String
ストリームの MIME タイプです。
- willSeek
- Boolean
ストリームをシーク可能にするかどうかを指定します。 false を指定すると、ストリームは順方向専用となり、作成時にチャンクとしてクライアントに送信されます。 true を指定すると、ストリームはディスクにスプールされ、閉じられるまで送信されません。 既定値は false です。
- operation
- StreamOper
メソッドが実行する操作 (StreamOper 値) を示します。
戻り値
ストリーム レポート。
注釈
レポートの本文は、作成される最初のストリームである必要があります。 別のストリームでこのストリームを参照するには、名前、ピリオド、および拡張子と連結された Report オブジェクトを使用StreamURLします。 たとえば、StreamURL が "myfiles" であり、これが "myImage" というストリームで、JPEG ファイルである場合、このストリームは "myFiles/myImage.jpg" として参照できます。
表示する複数のストリームを指定できます。 CreateAndRenderStream が初めて呼び出されると、レポートを含むプライマリ ストリームが返されます。 CreateAndRenderStream の後続の呼び出しでは、キャッシュに格納されている追加のストリームが返されます。 表示出力が複数のデータ チャンクから構成されている場合には、セカンダリ ストリームを使用します。 たとえば、HTML 表示拡張機能が画像を含んだレポートを表示する場合、この表示拡張機能は HTML ページをプライマリ ストリームとして表示し、各画像はセカンダリ ストリーム (画像ごとに 1 つのストリーム) となります。 HTML ページ内には、表示拡張機能によって、画像が含まれているセカンダリ ストリームへのリンクが配置されます。 HTML ページを開くと、ブラウザーは、これらのリンクを使用して画像の取得を試行します。 プライマリ ストリームからセカンダリ ストリームへのリンクを作成するには、前に StreamURL 示したように Report クラスのメソッドを使用します。