Click or drag to resize

LinkarCltUpdate Method (CredentialsOptions, String, String, String, UpdateOptions, String, String, Int32)

Update one or several records of a file, 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 Update(
	CredentialsOptions credentialsOptions,
	string filename,
	string recordIds,
	string records,
	UpdateOptions updateOptions = null,
	string originalRecords = "",
	string customVars = "",
	int receiveTimeout = 0
)

Parameters

credentialsOptions
Type: LinkarCommonCredentialsOptions
Object that defines the necessary data to access to the Linkar Server: Username, Password, EntryPoint, Language, FreeText.
filename
Type: SystemString
File name where you are going to write.
recordIds
Type: SystemString
It's the records codes list you want to register, separated by the Record Separator character (30).
records
Type: SystemString
Are the records you want to update, separated by the Record Separator character (30).
updateOptions (Optional)
Type: LinkarCommonUpdateOptions
Object that defines the different writing options of the Function: optimisticLockControl, readAfter, calculated, dictionaries, conversion, formatSpec, originalRecords.
originalRecords (Optional)
Type: SystemString
Are the original records that you want to update for Optimistic Block verifications, separated by the Record Separator character (30).
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
ExceptionCondition
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 filename = "LK.CUSTOMERS";
string recordId = "1";
string inputData = "..."; // Buffer with the content of record to be update
UpdateOptions updateOptions = new UpdateOptions();
string originalRecord = ""; // Buffer with the original record content (only necessary for use with optimistic lock control)

LkData lkDataUpdate = LinkarClt.Update(crdOpt, filename, recordId, inputData, updateOptions, originalRecord);
See Also