API Host CompileBlockOptions

CompileBlockOptions

轻量脚本块的选项

Options for a lightweight script block

.NET Host API 目录

.NET Host API Directory

概述

Overview

CompileBlockOptions 定义 CompileBlock 的位置参数名和诊断中的虚拟源码名。CompileBlock 只接受语句体，不能包含 @module、@global()、import、include、export 或 declare。

CompileBlockOptions defines positional parameter names and the virtual source name used in diagnostics. A CompileBlock accepts a statement body only; it cannot contain @module, @global(), import, include, export, or declare.

Parameters

用途

将位置实参暴露为块内局部变量。

Exposes positional arguments as local variables inside the block.

边界

名称不得为空、重复或使用 global、$args、$state。

Names cannot be empty, duplicate, or use global, $args, or $state.

var options = new CompileBlockOptions { Parameters = ["left", "right"] };

SourceName

用途

在诊断中显示的虚拟文件名。

Virtual filename shown in diagnostics.

var options = new CompileBlockOptions { SourceName = "rules/discount.as" };

using var block = engine.CompileBlock("return left + right;", new CompileBlockOptions
{
    Parameters = ["left", "right"],
    SourceName = "rules/sum.as"
});