Method MatrixSetOutputLockMode

Namespace

Skyline.DataMiner.Automation

Assembly

SLManagedAutomation.dll

MatrixSetOutputLockMode(int, int, bool)

Locks or unlocks the specified matrix output.

public virtual void MatrixSetOutputLockMode(int pid, int index, bool mode)

Parameters

pid int

The ID of the matrix parameter.

index int

The index of the matrix output.

mode bool

true to lock the output; otherwise, false.

Examples

var dummy = engine.GetDummy("dummy1");
dummy.MatrixSetOutputLockMode(1000, 1, true);

Remarks

index must be in the range 1..nrOfOutputs.

Exceptions

DataMinerException

The matrix parameter was not found.
-or-
index is not in the range 1..nrOfOutputs.

MatrixSetOutputLockMode(int, string, bool)

Locks or unlocks the specified matrix output.

public virtual void MatrixSetOutputLockMode(int pid, string outputLabel, bool mode)

Parameters

pid int

The ID of the matrix parameter.

outputLabel string

The label of the matrix output.

mode bool

true to lock the output; otherwise, false.

Examples

var dummy = engine.GetDummy("dummy1");
dummy.MatrixSetOutputLockMode(1000, "Output 1", true);

Exceptions

DataMinerException

The matrix parameter was not found.
-or-
There is no output with the specified label.

MatrixSetOutputLockMode(string, string, bool)

Locks or unlocks the specified matrix output.

note

Please use an overload that takes the parameter ID instead to prevent issues in case the parameter Description changes.

[Obsolete("Use overloads with parameter ID instead of name.")]
public virtual void MatrixSetOutputLockMode(string parameterName, string outputLabel, bool mode)

Parameters

parameterName string

The name of the matrix parameter.

outputLabel string

The label of the matrix output.

mode bool

true to lock the output; otherwise, false.

Examples

var dummy = engine.GetDummy("dummy1");
dummy.MatrixSetOutputLockMode("Example Matrix", "Output 1", true);

Remarks

The specified value for the parameterName argument should be the value of the Description tag of the parameter and not the value of the Name tag.

Exceptions

DataMinerException

The matrix parameter was not found.
-or-
There is no output with the specified label.

MatrixSetOutputLockMode(string, int, bool)

Locks or unlocks the specified matrix output.

note

Please use an overload that takes the parameter ID instead to prevent issues in case the parameter Description changes.

[Obsolete("Use overloads with parameter ID instead of name.")]
public virtual void MatrixSetOutputLockMode(string parameterName, int index, bool mode)

Parameters

parameterName string

The name of the matrix parameter.

index int

The index of the matrix output.

mode bool

true to lock the output; otherwise, false.

Examples

var dummy = engine.GetDummy("dummy1");
dummy.MatrixSetOutputLockMode("Example matrix", 1, true);

Remarks

The specified value for the parameterName argument should be the value of the Description tag of the parameter and not the value of the Name tag.

index must be in the range 1..nrOfOutputs.

Exceptions

DataMinerException

The matrix parameter was not found.
-or-
index is not in the range 1..nrOfOutputs.