| LinkarCltRunSubroutine Method (CredentialsOptions, String, Int32, String, String, Int32) |
Executes a subroutine, in a Synchronous way.
Direct Method.
Namespace:
LinkarClient
Assemblies:
LinkarClientCore (in LinkarClientCore.dll) Version: 2.1.0.0
LinkarClientMono (in LinkarClientMono.dll) Version: 2.1.0.0 (2.1.0.0)
LinkarClient (in LinkarClient.dll) Version: 2.1.0.0 (2.1.0.0)
Syntax public static LkData RunSubroutine(
CredentialsOptions credentialsOptions,
string subroutineName,
int argsNumber,
string arguments,
string customVars = "",
int receiveTimeout = 0
)
Public Shared Function RunSubroutine (
credentialsOptions As CredentialsOptions,
subroutineName As String,
argsNumber As Integer,
arguments As String,
Optional customVars As String = "",
Optional receiveTimeout As Integer = 0
) As LkData
public:
static LkData^ RunSubroutine(
CredentialsOptions^ credentialsOptions,
String^ subroutineName,
int argsNumber,
String^ arguments,
String^ customVars = L"",
int receiveTimeout = 0
)
static member RunSubroutine :
credentialsOptions : CredentialsOptions *
subroutineName : string *
argsNumber : int *
arguments : string *
?customVars : string *
?receiveTimeout : int
(* Defaults:
let _customVars = defaultArg customVars ""
let _receiveTimeout = defaultArg receiveTimeout 0
*)
-> LkData
Parameters
- credentialsOptions
- Type: LinkarCommonCredentialsOptions
Object that defines the necessary data to access to the Linkar Server: Username, Password, EntryPoint, Language, FreeText.
- subroutineName
- Type: SystemString
Subroutine name you want to execute. - argsNumber
- Type: SystemInt32
Number of arguments that the subroutine accepts. - arguments
- Type: SystemString
The subroutine arguments list separated by the DC4 (20) character, the number of elements in the list must coincide with the number of arguments. - customVars (Optional)
- Type: SystemString
It's a free text that will travel until the database to make the admin being able to manage additional behaviours in the standard routine SUB.LK.MAIN.CONTROL.CUSTOM. This routine will be called if the argument has content.
- receiveTimeout (Optional)
- Type: SystemInt32
It's the maximum time in seconds that the client will keep waiting the answer by the server. By default -1 (wait indefinitely).
Return Value
Type:
LkDataReturns an object of type
LkData with the results of the operation.
Exceptions Exception | Condition |
---|
SocketException | Thrown when there are communication problems between LINKAR Client and LINKAR Server |
LkException | Thrown when there are errors in LINKAR Client or LINKAR Server |
Examples CredentialsOptions crdOpt = new CredentialsOptions("127.0.0.1", 11300, "admin", "admin", "ENTRYPOINT");
string subroutineName = "SUB.DEMOLINKAR";
int argsNumber = 3;
string[] lstArgs = new string[] { "0", "qwerty", "" };
string arguments = DataFunctions.GetLstArgsForLkString(lstArgs);
LkData lkDataRunSubroutine = LinkarClt.RunSubroutine(crdOpt, subroutineName, argsNumber, arguments);
Dim crdOpt As CredentialsOptions = New CredentialsOptions("127.0.0.1", 11300, "admin", "admin", "ENTRYPOINT")
Dim subroutineName As String = "SUB.DEMOLINKAR"
Dim argsNumber As Integer = 3
Dim lstArgs As String() = New String() {"0", "qwerty", ""}
Dim arguments As String = DataFunctions.GetLstArgsForLkString(lstArgs)
Dim lkDataRunSubroutine As LkData = LinkarClt.RunSubroutine(crdOpt, subroutineName, argsNumber, arguments)
No code example is currently available or this language may not be supported.
No code example is currently available or this language may not be supported.
See Also