Click or drag to resize

LinkarClientNewAsync Method

Linkar Framework for .NET and Core


Creates one or several records of a file, in a asynchronous way with MV input and output format.

Namespace: Linkar.Functions.Persistent.MV
Assembly: Linkar.Functions.Persistent.MV (in Linkar.Functions.Persistent.MV.dll) Version: 2.3.1
Syntax
public Task<string> NewAsync(
	string filename,
	string records,
	NewOptions newOptions = null,
	string customVars = "",
	int receiveTimeout = 0
)

Parameters

filename  String
The file name where the records are going to be created.
records  String
Buffer of records to write. Inside this string are the recordIds, and the records. Use StringFunctions.ComposeNewBuffer (Linkar.Strings library) function to compose this string.
newOptions  NewOptions  (Optional)
Object with write options for the new record(s), including recordIdType, readAfter, calculated, dictionaries, conversion, formatSpec, originalRecords.
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.
Remarks
Inside the records argument, the records always must be specified. But the recordIds only must be specified when NewOptions argument is null, or when the RecordIdType argument of the NewOptions constructor is null.
Example
using Linkar;
using Linkar.Functions.Persistent.MV;

class Test
    {
        public string MyNew()
        {
            string result = "";
            try
            {
                CredentialOptions credentials = new CredentialOptions("127.0.0.1", "EPNAME", 11300, "admin", "admin");
                LinkarClient client = new LinkarClient();
                client.Login(credentials);

                result = client.NewAsync("LK.CUSTOMERS", "2" + ASCII_Chars.FS_chr + "CUSTOMER 2þADDRESS 2þ444").Result;
                client.Logout();
            }
            catch (Exception ex)
            {
                string error = ex.Message;
                // Do something
            }
            return result;
        }
    }
See Also