| 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
)
Public Shared Function Update (
credentialsOptions As CredentialsOptions,
filename As String,
recordIds As String,
records As String,
Optional updateOptions As UpdateOptions = Nothing,
Optional originalRecords As String = "",
Optional customVars As String = "",
Optional receiveTimeout As Integer = 0
) As LkData
public:
static LkData^ Update(
CredentialsOptions^ credentialsOptions,
String^ filename,
String^ recordIds,
String^ records,
UpdateOptions^ updateOptions = nullptr,
String^ originalRecords = L"",
String^ customVars = L"",
int receiveTimeout = 0
)
static member Update :
credentialsOptions : CredentialsOptions *
filename : string *
recordIds : string *
records : string *
?updateOptions : UpdateOptions *
?originalRecords : string *
?customVars : string *
?receiveTimeout : int
(* Defaults:
let _updateOptions = defaultArg updateOptions null
let _originalRecords = defaultArg originalRecords ""
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.
- 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:
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 filename = "LK.CUSTOMERS";
string recordId = "1";
string inputData = "...";
UpdateOptions updateOptions = new UpdateOptions();
string originalRecord = "";
LkData lkDataUpdate = LinkarClt.Update(crdOpt, filename, recordId, inputData, updateOptions, originalRecord);
Dim crdOpt As CredentialsOptions = New CredentialsOptions("127.0.0.1", 11300, "admin", "admin", "ENTRYPOINT")
Dim filename As String = "LK.CUSTOMERS"
Dim recordId As String = "1"
Dim inputData As String = "..."
Dim updateOptions As UpdateOptions = New UpdateOptions
Dim originalRecord As String = ""
Dim lkDataUpdate As LkData = LinkarClt.Update(crdOpt, filename, recordId, inputData, updateOptions, originalRecord)
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