API Host Reference

.NET Host API 参考

.NET Host API Reference

适用版本：4.0.0。

Applies to 4.0.0.

返回 API 参考

Back to API Reference

此目录列出当前 host-api.json 中记录的全部公开宿主类型。每个类型都有独立页面和简单使用样例；核心集成类型提供可直接使用的 C# 示例，底层运行时类型同时列出完整公开签名、参数、返回值和调用形状。

This directory lists every public host type recorded in the current host-api.json. Each type has its own page and a simple usage sample; core integration types provide directly usable C# examples, while lower-level runtime types also list their complete public signatures, parameters, returns, and call shapes.

引擎与配置 · Engine and Configuration

• AuroraEngine
• EngineOptions
• RuntimeOptions
• RuntimeOptionsBuilder
• CompilerOptions
• CompilerOptionsBuilder
• OptimizationOptions
• OptimizationOptionsBuilder
• OutputOptions
• OutputOptionsBuilder
• CompileBlockOptions
• CompiledBlock
• CompilationMode
• OptimizeOptions
• StringPoolingStrategy

源码与解析 · Sources and Resolution

• ScriptSources
• IScriptSourceResolver
• ScriptSource
• ScriptSourceReference
• ScriptSourceQuery
• ScriptResolveContext
• MemorySource
• MemorySourceResolver
• FileSystemScriptSourceResolver
• FileScriptSourceResolver
• CompositeScriptSourceResolver

执行、模块与热更新 · Execution, Modules, and Hot Patching

• ScriptDomain
• ScriptContext
• ScriptGlobal
• ScriptModule
• ClosureFunction
• HotPatchType

脚本值与运行时对象 · Script Values and Runtime Objects

• ScriptDatum
• ValueKind
• ScriptObject
• ObjectFlags
• ScriptArray
• ScriptHashMap
• StringBuffer
• StringValue
• NumberValue
• BooleanValue
• NullValue
• ScriptDate
• ScriptRegex
• ScriptProxy
• ScriptEnumerator
• ScriptError
• ScriptType

CLR 互操作与回调 · CLR Interop and Callbacks

• ClrTypeRegistry
• ClrType
• ClrInstanceObject
• ClrMarshaller
• TypeAccess
• BondingFunction
• BondingGetter
• ClrDatumDelegate
• ClrGetterDelegate
• ScriptFunctionDelegate
• ScriptMethodDelegate
• Extended

序列化、诊断与异常 · Serialization, Diagnostics, and Exceptions

• AuroraTypedDocument
• TypedDocumentSerializer
• TypedDocumentOptions
• TypedDocumentException
• ScriptJsonSerializer
• StandardScriptJsonSerializer
• DebuggerScriptSerializer
• AuroraException
• AuroraCompilationException
• AuroraRuntimeException
• AuroraCompilationDiagnostic
• AuroraStackTrace
• SourceSpan
• 异常总览

  Exceptions Overview

使用边界

Usage Boundaries

从 AuroraEngine、EngineOptions、ScriptDomain、ScriptSources、ScriptGlobal 和 ScriptDatum 开始即可完成多数宿主集成。Runtime.Types、原始 delegate 和 Resolver 实现类型面向高级集成；它们需要由宿主自行管理线程安全、生命周期和兼容性验证。

Most host integrations can begin with AuroraEngine, EngineOptions, ScriptDomain, ScriptSources, ScriptGlobal, and ScriptDatum. Runtime.Types, raw delegates, and Resolver implementation types are for advanced integration; the host must manage thread safety, lifetime, and compatibility validation.