Click or drag to resize

LinkarCltNew_Text Method (String, String, String, NewOptions, DATAFORMAT_TYPE, DATAFORMATCRU_TYPE, 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
public string New_Text(
	string filename,
	string recordIds,
	string records,
	NewOptions newOptions = null,
	DATAFORMAT_TYPE inputStringType = DATAFORMAT_TYPE.MV,
	DATAFORMATCRU_TYPE outputStringType = DATAFORMATCRU_TYPE.MV,
	string customVars = "",
	int receiveTimeout = -1
)

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.
inputStringType (Optional)
Type: LinkarCommonDATAFORMAT_TYPE
Indicates in what format you wish to send the resultant writing data: MV, XML or JSON.
outputStringType (Optional)
Type: LinkarCommonDATAFORMATCRU_TYPE
Indicates in what format you want to receive the data resulting from the Read, New, Update and Select operations: MV, XML, XML_DICT, XML_SCH, JSON, JSON_DICT or JSON_SCH.
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: String
Returns an object of type LkString 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
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 record to be new
NewOptions newOptions = new NewOptions();
DATAFORMAT_TYPE inputStringType = DATAFORMAT_TYPE.MV;
DATAFORMAT_TYPE outputStringType = DATAFORMAT_TYPE.MV;
string result = lkClt.New_Text(filename, recordId, inputData, newOptions, inputStringType, outputStringType);
See Also