跳到主要内容

SCL 变量作用域

作用域决定变量在哪些语句中可见;拆分方法、条件块或有状态功能块时需要核对。本页按顶层、代码块、参数和实例字段说明。规范名是 SCL,源码使用 C# 风格类、方法和访问级别,不要写成 Pascal 的 VAR / VAR_INPUT。

顶层作用域​

顶层变量可供同一代码段的顶层语句使用,适合保存扫描状态。

bool runState = false;
int cycleCount = 0;
string stateText = "Stopped";

if (runState)
{
cycleCount = cycleCount + 1;
stateText = "Running";
}

顶层变量会参与项目的运行状态,不应随意复用为临时值。

代码块作用域​

在 { } 内声明的变量,只应在该块中使用。

int result = 0;
bool enabled = true;

if (enabled)
{
int increment = 5;
result = result + increment;
}

// increment 在此处不可使用

为避免扁平化代码中的名称冲突,不要在内外层重复声明同名变量。

方法参数​

参数在整个方法体内可见。默认参数按值传入。

class MathTools
{
public int Add(int left, int right)
{
int result = left + right;
return result;
}
}

需要把结果写回调用方时,可使用已声明的 out 或 ref 参数。

class CounterTools
{
public void Increment(ref int value, bool enabled)
{
if (enabled)
{
value = value + 1;
}
}
}

CounterTools tools = new CounterTools();
int count = 0;
bool countEnable = true;
tools.Increment(ref count, countEnable);

调用点不能在 out 后内联声明变量;应先声明,再传入。

方法局部变量​

局部变量用于一次方法调用中的中间结果。不要用局部变量保存必须跨扫描保留的设备状态。

class TextTools
{
public string SelectState(bool running, bool fault)
{
string result = "Stopped";

if (fault)
{
result = "Fault";
}
else if (running)
{
result = "Running";
}

return result;
}
}

功能块字段​

类字段属于实例。相同类型的两个实例各自保存一份字段状态。

class LatchBlock
{
private bool state = false;
public bool Q { get; set; }

public void Execute(bool setCommand, bool resetCommand)
{
if (resetCommand)
{
state = false;
}
else if (setCommand)
{
state = true;
}

Q = state;
}
}

LatchBlock first = new LatchBlock();
LatchBlock second = new LatchBlock();

访问级别​

修饰符类别访问可见范围
public访问级别读写调用方可访问
private访问级别读写(仅类内)仅当前类可访问
protected访问级别读写(类与派生类)当前类和派生类可访问
internal访问级别读写(当前项目)当前项目内可访问

设备状态字段通常保持 private,通过公开方法和输出属性访问。

作用域检查​

  • 临时变量不逃出声明它的 { }。
  • 不在嵌套块重复声明同名变量。
  • 跨扫描状态使用顶层变量或实例字段。
  • out 和 ref 实参先声明且可写。
  • 两个设备对象使用两个独立功能块实例。