Beschreibung:
Führt eine SQL-Anweisung direkt aus. Es wird dabei die aktuelle Verbindung zur Datenbank der Solution verwendet.
Parameter:
|
Parametername |
Typ |
Beschreibung |
|
SQLCommand |
String |
SQL-Anweisung |
Hinweis: Es macht keinen Sinn, hierüber eine SELECT Anweisung abzusetzen, da man hierüber das Ergebnis nicht abfragen/durchlaufen kann. Einsatzzweck sind UPDATE, INSERT, DELETE Anweisungen oder ggf. das Aufrufen von Stored Procedures.
Rückgabewert:
Long
|
Wert |
Beschreibung |
|
>= 0 |
Anzahl der betroffenen Datensätze bei UPDATE oder DELETE Anweisungen. |
|
0 |
Rückgabewert bei INSERT Anweisungen oder dem Aufruf von Stored Procedures. |
|
-1 |
Fehler bzw. Rückgabewert bei Ausführung einer SQL-Abfrage ohne Datenmanipulation (z. B. mittels CREATE/DROP FUNCTION-Anweisungen) und bei gleichzeitigem Rückgabewert von 0 für die Eigenschaft SQLShell.LastError.ErrorCode. |
' Dieses Beispiel basiert auf der Firmen-Ansicht einer combit_Large-Solution
Dim nResult : nResult = SQLShell.ExecuteCommandRaw("UPDATE ""Companies"" SET ""ABC"" = 'A'")
If (nResult = -1) Then
Call cRM.DialogMessageBox("Es ist ein Fehler aufgetreten." & vbCrLf & SQLShell.LastError.ErrorCode & ": " & SQLShell.LastError.ErrorText, "SQLShell", vbOkOnly)
Else
Call cRM.DialogMessageBox(nResult & " Datensätze betroffen.", "SQLShell", vbOkOnly)
End If
Beispiel C#-Script:
// Dieses Beispiel basiert auf der Firmen-Ansicht einer combit_Large-Solution
long result = SQLShell.ExecuteCommandRaw("UPDATE \"Companies\" SET \"ABC\" = 'A'");
if (result == -1)
{
cRM.DialogMessageBox("Es ist ein Fehler aufgetreten." + System.Environment.NewLine + SQLShell.LastError.ErrorCode.ToString() + ": " + SQLShell.LastError.ErrorText, "SQLShell", 0);
}
else
{
cRM.DialogMessageBox(result & " Datensätze betroffen.", "SQLShell", 0);
}