| LinkarCltNewT Method (CredentialsOptions, String, ListT, NewOptions, String, Int32) |
Creates one or several records of a file, in a synchronous way
Direct Method.
Namespace:
LinkarClient
Assemblies:
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 List<T> New<T>(
CredentialsOptions credentialsOptions,
string filename,
List<T> records,
NewOptions newOptions = null,
string customVars = "",
int receiveTimeout = 0
)
Public Shared Function New(Of T) (
credentialsOptions As CredentialsOptions,
filename As String,
records As List(Of T),
Optional newOptions As NewOptions = Nothing,
Optional customVars As String = "",
Optional receiveTimeout As Integer = 0
) As List(Of T)
public:
generic<typename T>
static List<T>^ New(
CredentialsOptions^ credentialsOptions,
String^ filename,
List<T>^ records,
NewOptions^ newOptions = nullptr,
String^ customVars = L"",
int receiveTimeout = 0
)
static member New :
credentialsOptions : CredentialsOptions *
filename : string *
records : List<'T> *
?newOptions : NewOptions *
?customVars : string *
?receiveTimeout : int
(* Defaults:
let _newOptions = defaultArg newOptions null
let _customVars = defaultArg customVars ""
let _receiveTimeout = defaultArg receiveTimeout 0
*)
-> List<'T>
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. - records
- Type: System.Collections.GenericListT
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).
Type Parameters
- T
Exclusive for .NET & Mono
Some functions can accept and return values directly from a class. These classes must contain extra information in their properties to be able to link with the data sent or received.
The data dump regarding the classes is made through reflection, record by record. This means that it will take a little longer to process each record.
For this reason, it is not recommended that a great number of records be obtained at once.
This is achieved through the following metadata:
- MVProperty -
This attribute tells the Linkar client that he must try to supply this field with the operations information. The following properties are used to link the feature with its internal value
- AttributeNumber - Number of the property attribute. It is compulsory to specify this property or the Dictionaryname property.
- DictionaryName - The name of the property dictionary. It is compulsory to specify this property or AttributeNumber property.
- InternalType - Data conversions that will be made in the client. None: default value, indicates that the conversion type is not required by the client.
- InternalDate - The value is saved as an internal date.
- FormatedDate - The value is saved as a formatted date.
- MVCalculated -
The client must try to supply this calculated field with the operations data. The following properties are used to link the feature with its internal value:
- DictionaryName - The name of the calculated dictionary. This property is mandatory.
- InternalType - Data conversions that are made in the client
- None - Default value, a conversion type is not required by the client.
- InternalDate - Value is saved as an internal date.
- FormatedDate - Value is saved as a formatted date.
- MVList -
This is used on list type objects and indicates that the Linkar client must go across to collect their values and complete them. When situated in the main class is understood that it is a multivalue list, in a secondary class, they will be treated as subvalues, and from there to next they will be ignored.
Return Value
Type:
ListTThe record's list 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 |
See Also