CATable::GraphToStream

ADE User Guide > ADE Server Class Reference > CATable

bool GraphToStream(stream, mimeType)

描述

建立一个数据包含在CATable对象中的图像，数据使用mimeType格式化并写入到文件stream（流）中。通过表格的GraphWidth和GraphHeight属性控制图形像素大小。

Note: Note: An IStream is not interchangeable with a .NET System.Io.Stream object (including a Response.OutputStream object in ASP.NET). A wrapper class is necessary for converting between these. TBD: The Wrapper class and more instructions should be included here.

返回值

布尔值（成功）

参 数

• stream：字符串
• mimeType ：字符串， 使用以下代码之一：
  • "image/png"
  • "image/jpeg"
  • "image/bmp"
  • "image/tiff"

Detailed Instructions

These instructions are copied from the ADE User Guide: Using the Analytica Graphing Engine, in Chapter 4.

When you have a CATable result with at least one dimension, you can obtain a graph of the result as an image. One use of this is to embed graphs as JPEG images in a web page that uses ADE on the back end.

Obtaining the graph of a result requires the following steps:

1. Select the appropriate graph settings, such as chart type, axis range settings, colors, fonts,and so on. The easiest way is to open the model in Analytica Enterprise, and select the settings you want for each variable using the Graph Setup dialog.
   The graph template you create using the Graph Setup dialog is stored in the GraphSetup attribute of the object. You can copy the GraphSetup attribute from an existing variable if you need to change the style template.
2. From ADE, obtain a CATable with the result to be graphed.
3. Set the GraphWidth and GraphHeight properties of the CATable object to indicate the desired size of the graph in pixels.
4. If your result has more than two dimensions, call Slice or Subscript to reduce the dimensionality to the desired dimensionality for the plot (usually one dimension if there is no key or two dimensions if there is a key).
5. If you have more than one dimension, call SetIndexOrder to select the desired pivot for the graph.
6. If you are sending the graph to an output stream, obtain a Windows IStream interface to the stream. If you have a .NET Stream (System.io.Stream), you need to use a wrapper class (see below).
7. Call either the GraphToStream or GraphToFile methods of CATable, depending on where you want the graph written to. The graph can be created in different MIME types (e.g., "image/JPEG").

Usage

tab.GraphWidth = 350
tab.GraphHeight = 200
dim outStream as StringConnector = _new StreamConnector(Response.OutputStream)
b = tab.GraphToStream( outStream, "image/jpeg")

See Also

• ADE User Guide, Using the Analytica Graphing Engine in Chapter 4
• CATable::GraphToFile