LinkarCltNew Method (String, String, String, NewOptions, String, Int32)

Creates one or several records of a file, in a synchronous way

Persistent 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

C++

Copy

public LkData New(
	string filename,
	string recordIds,
	string records,
	NewOptions newOptions = null,
	string customVars = "",
	int receiveTimeout = -1
)

Public Function New ( 
	filename As String,
	recordIds As String,
	records As String,
	Optional newOptions As NewOptions = Nothing,
	Optional customVars As String = "",
	Optional receiveTimeout As Integer = -1
) As LkData

public:
LkData^ New(
	String^ filename, 
	String^ recordIds, 
	String^ records, 
	NewOptions^ newOptions = nullptr, 
	String^ customVars = L"", 
	int receiveTimeout = -1
)

member New : 
        filename : string * 
        recordIds : string * 
        records : string * 
        ?newOptions : NewOptions * 
        ?customVars : string * 
        ?receiveTimeout : int 
(* Defaults:
        let _newOptions = defaultArg newOptions null
        let _customVars = defaultArg customVars ""
        let _receiveTimeout = defaultArg receiveTimeout -1
*)
-> LkData

Parameters

filename: Type: SystemString
File name where you are going to write.
recordIds: Type: SystemString
It's the records codes list you want to write, separated by the Record Separator character (30). In case they are empty, you will have to use one of the newOptions options.
records: Type: SystemString
Are the records you want to write, separated by the Record Separator character (30).
newOptions (Optional): Type: LinkarCommonNewOptions
Object that defines the following writing options of the Function: recordIdType, readAfter, calculated, dictionaries, conversion, formatSpec, originalRecords.
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: LkData
Returns 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

C++

Copy

LinkarClt lkClt = new LinkarClt();
CredentialsOptions crdOpt = new CredentialsOptions("127.0.0.1", 11300, "admin", "admin", "ENTRYPOINT");
lkClt.Login(crdOpt);

string filename = "LK.CUSTOMERS";
string recordId = "101";
string inputData = "..."; // Buffer with the content of the new record
NewOptions newOptions = new NewOptions();
LkData lkDataNew = lkClt.New(filename, recordId, inputData, newOptions);

Dim lkClt As LinkarClt = New LinkarClt()
Dim crdOpt As CredentialsOptions = New CredentialsOptions("127.0.0.1", 11300, "admin", "admin", "ENTRYPOINT")
lkClt.Login(crdOpt)

Dim filename As String = "LK.CUSTOMERS"
Dim recordId As String = "101"
Dim dictClause As String = ""
Dim inputData As String = "..." 'Buffer with the content of the new record
Dim newOptions As NewOptions = New NewOptions()
Dim lkDataNew As LkData = lkClt.[New](filename, recordId, inputData, newOptions)

Reference

LinkarClt Class

New Overload

LinkarClient Namespace

LinkarCltAddLanguageSpecificTextSet("LST86F4CC93_0?cpp=::|nu=.");New Method (String, String, String, NewOptions, String, Int32)

Parameters

Return Value

Reference

LinkarCltNew Method (String, String, String, NewOptions, String, Int32)