FunctionsConversionAsync Method

Linkar Framework for .NET and Core

Returns the result of executing ICONV() or OCONV() functions from a expression list in the Database, in a asynchronous way with MV output format.

Namespace: Linkar.Functions.Direct.MV
Assembly: Linkar.Functions.Direct.MV (in Linkar.Functions.Direct.MV.dll) Version: 2.3.1

Syntax

C++

Copy

public static Task<string> ConversionAsync(
	CredentialOptions credentialOptions,
	CONVERSION_TYPE conversionType,
	string expression,
	string code,
	string customVars = "",
	int receiveTimeout = 0
)

Public Shared Function ConversionAsync ( 
	credentialOptions As CredentialOptions,
	conversionType As CONVERSION_TYPE,
	expression As String,
	code As String,
	Optional customVars As String = "",
	Optional receiveTimeout As Integer = 0
) As Task(Of String)

public:
static Task<String^>^ ConversionAsync(
	CredentialOptions^ credentialOptions, 
	CONVERSION_TYPE conversionType, 
	String^ expression, 
	String^ code, 
	String^ customVars = L"", 
	int receiveTimeout = 0
)

static member ConversionAsync : 
        credentialOptions : CredentialOptions * 
        conversionType : CONVERSION_TYPE * 
        expression : string * 
        code : string * 
        ?customVars : string * 
        ?receiveTimeout : int 
(* Defaults:
        let _customVars = defaultArg customVars ""
        let _receiveTimeout = defaultArg receiveTimeout 0
*)
-> Task<string>

Parameters

credentialOptions CredentialOptions: Object with data necessary to access the Linkar Server: Username, Password, EntryPoint, Language, FreeText.
conversionType CONVERSION_TYPE: Indicates the conversion type, input or output: INPUT=ICONV(); OUTPUT=OCONV()
expression String: The data or expression to convert. May include MV marks (value delimiters), in which case the conversion will execute in each value obeying the original MV mark.
code String: The conversion code. Must obey the Database conversions specifications.
customVars String (Optional): Free text sent to the database allows management of additional behaviours in SUB.LK.MAIN.CONTROL.CUSTOM, which is called when this parameter is set.
receiveTimeout Int32 (Optional): Maximum time in seconds that the client will wait for a response from the server. Default = 0 to wait indefinitely.

Return Value

TaskString
The results of the operation.

Example

C++

Copy

using Linkar;
using Linkar.Functions.Direct.MV;

class Test
    {
        public string MyConversion()
        {
            string result = "";
            try
            {
                CredentialOptions credentials = new CredentialOptions("127.0.0.1", "EPNAME", 11300, "admin", "admin");

                result = Functions.ConversionAsync(credentials, CONVERSION_TYPE.INPUT, "31-12-2017þ01-01-2018", "D2-").Result;
            }
            catch (Exception ex)
            {
                string error = ex.Message;
                // Do something
            }
            return result;
        }
    }

Imports Linkar
Imports Linkar.Functions.Direct.MV

Class Test

    Public Function MyConversion() As String
        Dim result As String = ""

        Try
            Dim credentials As CredentialOptions = New CredentialOptions("127.0.0.1", "EPNAME", 11300, "admin", "admin")

            result = Functions.ConversionAsync(credentials, CONVERSION_TYPE.INPUT,"31-12-2017þ01-01-2018","D2-").Result
        Catch ex As Exception

            Dim[error] As String = ex.Message
            ' Do something
        End Try

        Return result
  End Function
End Class

Reference

Functions Class

Linkar.Functions.Direct.MV Namespace