ADOHelper

Zugriffsklasse für die Interaktion mit der Datenbank

Eigenschaften

DatabaseName

get DatabaseName(): string

Datenbankname

Rückgabewert

string

Definiert in

SDK/Cosmolink.Scripting.SDK.ADO.ts:855

---

HasError

get HasError(): boolean

Angabe ob der zuletzt ausgeführte Befehl einen Fehler ausgelöst hat

Rückgabewert

boolean

Definiert in

SDK/Cosmolink.Scripting.SDK.ADO.ts:837

---

InstanceName

get InstanceName(): string

Instanzname

Rückgabewert

string

Definiert in

SDK/Cosmolink.Scripting.SDK.ADO.ts:864

---

LastError

get LastError(): ADOLastError

Das ADOLastError -Objekt des letzten ausgeführten Befehls

Rückgabewert

ADOLastError

Definiert in

SDK/Cosmolink.Scripting.SDK.ADO.ts:803

---

ServerVersion

get ServerVersion(): string

Version des Servers

Rückgabewert

string

Definiert in

SDK/Cosmolink.Scripting.SDK.ADO.ts:846

---

Timeout

get Timeout(): number

Verbindungstimeout

set Timeout(val): void

Verbindungstimeout

Parameter

Parameter	Type
val	number

Rückgabewert

number

Definiert in

SDK/Cosmolink.Scripting.SDK.ADO.ts:821

---

UserName

get UserName(): string

Benutzername

Rückgabewert

string

Definiert in

SDK/Cosmolink.Scripting.SDK.ADO.ts:873

Konstruktoren

new ADOHelper()

new ADOHelper(connectionStringBuilder): ADOHelper

Konstruktor

Parameter

Parameter	Type	Description
connectionStringBuilder	ADOConnectionBuilder	Verbindungszeichenfolgenquelle

Rückgabewert

ADOHelper

Definiert in

SDK/Cosmolink.Scripting.SDK.ADO.ts:883

Methoden

CreateNewInstance()

CreateNewInstance(): ADOHelper

Erstellt eine neue unabhängige ADOHelper Instanz als Kopie

Rückgabewert

ADOHelper

Definiert in

SDK/Cosmolink.Scripting.SDK.ADO.ts:896

---

ExecuteCommandRaw()

ExecuteCommandRaw(adoSqlCommand)

ExecuteCommandRaw(adoSqlCommand): number

Führt ein Sql-Statement aus und gibt die Anzahl der veränderten Zeilen zurück.

Parameter

Parameter	Type	Description
adoSqlCommand	ADOSqlCommand	Sql-Statement

Rückgabewert

number

Anzahl der veränderte Zeilen oder -1 wenn ein Fehler aufgetreten ist

Definiert in

SDK/Cosmolink.Scripting.SDK.ADO.ts:945

ExecuteCommandRaw(command)

ExecuteCommandRaw(command): number

Führt ein Sql-Statement aus und gibt die Anzahl der veränderten Zeilen zurück.

Parameter

Parameter	Type	Description
command	string	Sql-Statement

Rückgabewert

number

Anzahl der veränderte Zeilen oder -1 wenn ein Fehler aufgetreten ist

Definiert in

SDK/Cosmolink.Scripting.SDK.ADO.ts:954

---

ExecuteCommandRawAsync()

ExecuteCommandRawAsync(adoSqlCommand)

ExecuteCommandRawAsync(adoSqlCommand): Promise<number>

Führt ein Sql-Statement asynchron aus und gibt die Anzahl der veränderten Zeilen zurück.

Parameter

Parameter	Type	Description
adoSqlCommand	ADOSqlCommand	Sql-Statement

Rückgabewert

Promise<number>

Anzahl der veränderte Zeilen oder -1 wenn ein Fehler aufgetreten ist

Definiert in

SDK/Cosmolink.Scripting.SDK.ADO.ts:917

ExecuteCommandRawAsync(command)

ExecuteCommandRawAsync(command): Promise<number>

Führt ein Sql-Statement asynchron aus und gibt die Anzahl der veränderten Zeilen zurück.

Parameter

Parameter	Type	Description
command	string	Sql-Statement

Rückgabewert

Promise<number>

Anzahl der veränderte Zeilen oder -1 wenn ein Fehler aufgetreten ist

Definiert in

SDK/Cosmolink.Scripting.SDK.ADO.ts:926

---

ExecuteScalar()

ExecuteScalar(t, adoSqlCommand, format)

ExecuteScalar<T>(
   t, 
   adoSqlCommand, 
   format?): T

Führt ein Sql-Statement aus und gibt den Wert im gewünschten Format zurück.

Type Parameters

Type Parameter
T extends string | number | boolean | Date

Parameter

Parameter	Type	Description
t	CLType<T>	Generischer Parameter. Der Wert muss einem Wert von CLType entsprechen
adoSqlCommand	ADOSqlCommand	Sql-Statement
format?	string	Optional: Format für Stringumwandlung

Rückgabewert

T

Ergebnis des Sql-Statements als T

Definiert in

SDK/Cosmolink.Scripting.SDK.ADO.ts:1015

ExecuteScalar(t, command, format)

ExecuteScalar<T>(
   t, 
   command, 
   format?): T

Führt ein Sql-Statement aus und gibt den Wert im gewünschten Format zurück.

Type Parameters

Type Parameter
T extends string | number | boolean | Date

Parameter

Parameter	Type	Description
t	CLType<T>	Generischer Parameter. Der Wert muss einem Wert von CLType entsprechen
command	string	Sql-Statement
format?	string	Optional: Format für Stringumwandlung

Rückgabewert

T

Ergebnis des Sql-Statements als T

Definiert in

SDK/Cosmolink.Scripting.SDK.ADO.ts:1026

---

ExecuteScalarAsync()

ExecuteScalarAsync(t, adoSqlCommand, format)

ExecuteScalarAsync<T>(
   t, 
   adoSqlCommand, 
format?): Promise<T>

Führt ein Sql-Statement asynchron aus und gibt den Wert im gewünschten Format zurück.

Type Parameters

Type Parameter
T extends string | number | boolean | Date

Parameter

Parameter	Type	Description
t	CLType<T>	Generischer Parameter. Der Wert muss einem Wert von CLType entsprechen
adoSqlCommand	ADOSqlCommand	Sql-Statement
format?	string	Optional: Format für Stringumwandlung

Rückgabewert

Promise<T>

Ergebnis des Sql-Statements als T

Definiert in

SDK/Cosmolink.Scripting.SDK.ADO.ts:975

ExecuteScalarAsync(t, command, format)

ExecuteScalarAsync<T>(
   t, 
   command, 
format?): Promise<T>

Führt ein Sql-Statement asynchron aus und gibt den Wert im gewünschten Format zurück.

Type Parameters

Type Parameter
T extends string | number | boolean | Date

Parameter

Parameter	Type	Description
t	CLType<T>	Generischer Parameter. Der Wert muss einem Wert von CLType entsprechen
command	string	Sql-Statement
format?	string	Optional: Format für Stringumwandlung

Rückgabewert

Promise<T>

Ergebnis des Sql-Statements als T

Definiert in

SDK/Cosmolink.Scripting.SDK.ADO.ts:986

---

GetRecordSet()

GetRecordSet(adoSqlCommand, ignoreSchema)

GetRecordSet(adoSqlCommand, ignoreSchema?): ADORecordSet

Gibt ein ADORecordSet anhand einer SQL Query zurück
Eine Paralelle Ausführung dieser Funktion wird nicht unterstützt. Paralellisierung ist nur möglich über mehrere ADOHelper Objekte.

Parameter

Parameter	Type	Description
adoSqlCommand	ADOSqlCommand	Sql-Statement
ignoreSchema?	boolean	true wenn kein Sql-Schema geladen werden soll, andernfalls false Das Sql-Schema wird beispielsweise für PrimaryKeyFldName oder Save() benötigt Wird das Schema nicht direkt geladen, wird beim Zugriff auf die oben genannten Eigenschaften/Methoden versucht, dass Schema nachzuladen

Rückgabewert

ADORecordSet

Rückgabe: ADORecordSet oder null wenn das Sql-Statement fehlgeschlagen ist

Definiert in

SDK/Cosmolink.Scripting.SDK.ADO.ts:1188

GetRecordSet(command, ignoreSchema)

GetRecordSet(command, ignoreSchema?): ADORecordSet

Gibt ein ADORecordSet anhand einer SQL Query zurück
Eine Paralelle Ausführung dieser Funktion wird nicht unterstützt. Paralellisierung ist nur möglich über mehrere ADOHelper Objekte.

Parameter

Parameter	Type	Description
command	string	Sql-Statement
ignoreSchema?	boolean	true wenn kein Sql-Schema geladen werden soll, andernfalls false Das Sql-Schema wird beispielsweise für PrimaryKeyFldName oder Save() benötigt Wird das Schema nicht direkt geladen, wird beim Zugriff auf die oben genannten Eigenschaften/Methoden versucht, dass Schema nachzuladen

Rückgabewert

ADORecordSet

Rückgabe: ADORecordSet oder null wenn das Sql-Statement fehlgeschlagen ist

Definiert in

SDK/Cosmolink.Scripting.SDK.ADO.ts:1201

---

GetRecordSetAsync()

GetRecordSetAsync(adoSqlCommand, ignoreSchema)

GetRecordSetAsync(adoSqlCommand, ignoreSchema?): Promise<ADORecordSet>

Gibt ein ADORecordSet aynchron anhand einer SQL Query zurück
Eine Paralelle Ausführung dieser Funktion wird nicht unterstützt. Paralellisierung ist nur möglich über mehrere ADOHelper Objekte.

Parameter

Parameter	Type	Description
adoSqlCommand	ADOSqlCommand	Sql-Statement
ignoreSchema?	boolean	true wenn kein Sql-Schema geladen werden soll, andernfalls false Das Sql-Schema wird beispielsweise für PrimaryKeyFldName oder Save() benötigt Wird das Schema nicht direkt geladen, wird beim Zugriff auf die oben genannten Eigenschaften/Methoden versucht, dass Schema nachzuladen

Rückgabewert

Promise<ADORecordSet>

Rückgabe: ADORecordSet oder null wenn das Sql-Statement fehlgeschlagen ist

Definiert in

SDK/Cosmolink.Scripting.SDK.ADO.ts:1127

GetRecordSetAsync(command, ignoreSchema)

GetRecordSetAsync(command, ignoreSchema?): Promise<ADORecordSet>

Gibt ein ADORecordSet anhand einer SQL Query zurück
Eine Paralelle Ausführung dieser Funktion wird nicht unterstützt. Paralellisierung ist nur möglich über mehrere ADOHelper Objekte.

Parameter

Parameter	Type	Description
command	string	Sql-Statement
ignoreSchema?	boolean	true wenn kein Sql-Schema geladen werden soll, andernfalls false Das Sql-Schema wird beispielsweise für PrimaryKeyFldName oder Save() benötigt Wird das Schema nicht direkt geladen, wird beim Zugriff auf die oben genannten Eigenschaften/Methoden versucht, dass Schema nachzuladen

Rückgabewert

Promise<ADORecordSet>

Rückgabe: ADORecordSet oder null wenn das Sql-Statement fehlgeschlagen ist

Definiert in

SDK/Cosmolink.Scripting.SDK.ADO.ts:1140

---

GetRecordSetCollection()

GetRecordSetCollection(adoSqlCommand)

GetRecordSetCollection(adoSqlCommand): ADORecordSetCollection

Gibt eine ADORecordSetCollection anhand einer SQL Query zurück
Eine Paralelle Ausführung dieser Funktion wird nicht unterstützt. Paralellisierung ist nur möglich über mehrere ADOHelper Objekte.

Parameter

Parameter	Type	Description
adoSqlCommand	ADOSqlCommand

Rückgabewert

ADORecordSetCollection

Definiert in

SDK/Cosmolink.Scripting.SDK.ADO.ts:1052

GetRecordSetCollection(command)

GetRecordSetCollection(command): ADORecordSetCollection

Gibt eine ADORecordSetCollection anhand einer SQL Query zurück
Eine Paralelle Ausführung dieser Funktion wird nicht unterstützt. Paralellisierung ist nur möglich über mehrere ADOHelper Objekte.

Parameter

Parameter	Type	Description
command	string

Rückgabewert

ADORecordSetCollection

Definiert in

SDK/Cosmolink.Scripting.SDK.ADO.ts:1060

---

GetRecordSetCollectionAsync()

GetRecordSetCollectionAsync(adoSqlCommand)

GetRecordSetCollectionAsync(adoSqlCommand): Promise<ADORecordSetCollection>

Gibt eine ADORecordSetCollection anhand einer SQL Query zurück
Eine Paralelle Ausführung dieser Funktion wird nicht unterstützt. Paralellisierung ist nur möglich über mehrere ADOHelper Objekte.

Parameter

Parameter	Type	Description
adoSqlCommand	ADOSqlCommand

Rückgabewert

Promise<ADORecordSetCollection>

Definiert in

SDK/Cosmolink.Scripting.SDK.ADO.ts:1087

GetRecordSetCollectionAsync(command)

GetRecordSetCollectionAsync(command): Promise<ADORecordSetCollection>

Gibt eine ADORecordSetCollection anhand einer SQL Query zurück
Eine Paralelle Ausführung dieser Funktion wird nicht unterstützt. Paralellisierung ist nur möglich über mehrere ADOHelper Objekte.

Parameter

Parameter	Type	Description
command	string

Rückgabewert

Promise<ADORecordSetCollection>

Definiert in

SDK/Cosmolink.Scripting.SDK.ADO.ts:1095

---

TestConnection()

TestConnection(): void

Testet die im ADOHelper hinterlegte Datenbankverbindung

Rückgabewert

void

Throws

ArgumentNullException - Der ConnectionBuilder wurde nicht initialisiert

Throws

InvalidOperationException - Verbindung ist bereits geöffnet oder die Angabe der Datenquelle fehlt

Throws

SqlException - Beim Öffnen der Verbindung ist ein Fehler auf Verbindungsebene aufgetreten. Wenn die Number-Eigenschaft den Wert 18487 oder 18488 enthält, weist dies darauf hin, dass das angegebene Kennwort abgelaufen ist oder zurückgesetzt werden muss.

Definiert in

SDK/Cosmolink.Scripting.SDK.ADO.ts:1248

---

[hasInstance]()

static hasInstance: boolean

Symbol.hasInstance welches eine benutzerdefinierte Überprüfung der 'instanceof'-Operation für Objekte ermöglicht.

Parameter

Parameter	Type
value	any

Rückgabewert

boolean

Definiert in

SDK/Cosmolink.Scripting.SDK.ADO.ts:1257