CAEngine

ADE 用户指南 > ADE服务器类型参考 >

建立

ADE的使用从建立CAEngine对象开始，其它一切都从它开始产生。如果你使用ADEW.dll进程内服务器，你只能建立和使用一个CAEngine实例，如果你使用ADE.exe进程外服务器，你想建立多少个CAEngine实例都可以，每一个实例作为一个单一进程允许。在基于网络的应用程序里面，对于每一个用户会话都建立了一个单独的CAEngine实例。每一个CAEngine实例每次都可以载入一个模型。

你可以直接建立一个CAEngine实例，或者通过调用 CALicense::NewCAEngine()。后一方法需要你先建立一个 CALicense实例，其优点就是能够获得关于建立实例失败原因的更多信息。如果ADE使用许可证在指定计算机上无效，或者到期，直接建立CAEngine实例将失败。

属性

{get,put} string Command

在 Send()方法被调用时，将保持被执行的typescrip指令。

{get,put} CAObject CurrentModule

新建立的对象放在 CurrentModule中；因此，在建立任何新对象前，你应该设定 CurrentModule。设置： CurrentModule = Nothing表示没有模块打开，所有新对象都在顶层模块或者当前已经打开的模型中建立。

{get,put} CARenderingStyle DefaultDefTableRenderingStyle

控制定义表格值如何传入和传出ADE的默认风格类型。所有从 CAObject::DefTable返回的定义表在建立之初都继承这些设置。

{get,put} long DefaultEvaluationTimeLimit

对 CAEngine中的方法，例如 SendCommand， Send， OpenModel和 AddModule，以及任何被实例化的 CAObject的 CAObject::MethodEvaluationTimeLimit默认值等等，指定求值计算时的大时间限制（毫秒）。

{get,put} CARenderingStyle DefaultRenderingStyle

默认显示风格控制结果值如何从ADE返回。所有 实例在建立的时候都继承该显示风格。

{get} short int ErrorCode

返回最近一次与ADE服务器通讯产生的错误代码。 ErrorCode属性应该在设置和检索关键 CAEngine属性和CAEngine方法后检查。零错误代码表示最后的动作是成功的。

{get} string ErrorText

来自于 ErrorCode的短文本错误解释。

{get,put} unsigned long Flags

控制ADE内部某种行为的位域标志。

{get} string Log

当Photo属性true时，获取关于发送给ADE typescript的指令和从这些指令检索的结果的记录。

{get} string OutputBuffer

包含最后的typescript 结果的本文字符串缓冲（例如，使用Command属性和Send方法）与ADE相互作用。

{get,put} bool Photo

当Photo为True时，ADE将所有typescript指令和结果记录到 |Log属性当中。

方法

string AddModule(string filePath,bool Merge)

将来自文件fileName的模块添加到CurrentModule中。合并参数当前没有任何作用，应该设置成True。

bool CloseModel()

关闭模型

CAObject CreateObject(string objName, string objType)

在CurrentModule当中建立一个标识符为objName，类型为objClass的新Analytica对象，并作为一个CAObject返回。

bool CreateModel(string newModelName)

建立一个标识符为modelName的新Analytica模型。

bool DeleteObject( CAObject aObject )

从当前模型中删除CAObject对象。

CAObject Get(string objName)

与 GetObjectByName等同

CAObject GetObjectByName(string objName)

返回一个 CAObject类型对象给标识符为objName的现有Analytica对象。

bool MonitorProcess(long pid)

（需要ADE 4.3或者以上版本）如果指示的进程在它ADE之前终止，将指示ADE终止（终止自己）。在调试使用ADE来阻止僵尸ADE进程的代码时，如果你的代码提前终止，而没有机会正确实发其对象时非常有用。

string OpenModel(string filepath)

从磁盘文件读入一个模型，并作为当前模型打开。

bool ReadScript(string filePath)

读入并执行一个Analytica脚本文件。

void ResetError()

重置与错误代码有关的错误代码、错误文本字符串，并输出缓存给默认值。该函数一般内部使用，单在其他环境可能也非常有用。

bool SaveModel(string filePath)

将模型保存到«filePath»文件中。

bool SaveModuleFile(string moduleName, string filePath)

将标识符为«moduleName»的模块保存到«filePath»文件中。

bool Send()

将包含在Command属性内的字符串作为指令发送给ADE去执行。 关于指令和语法的详细信息请参考Analytica脚本指南。

bool SendCommand(string command)

将字符串指令属性作为typescript 指令ADE去执行。 关于指令和语法的详细信息请参考Analytica脚本指南。

bool SetCallbackObject(IUnknown* pCallbackObj)

ADE 4.6新特征

当求值计算在经常内时，你可以调用该方法以便提供一个执行各种回调接口，例如 IAdeUICallbacks，的对象来允许和终端用户互动。

另请参考

ADE服务器类型参考 <-

CAEngine

-> CAObject