TccScriptThreads.Add

Owned by Former user (Deleted)
Juni 12, 2017
1 min read

Parameter

(Script : String; const Priority : TThreadPriority = tpNormal; const Name : String = ' ') : Integer;

Beschreibung

Mit Add fügen Sie dem ScriptThread-Objekt einen neuen Thread mit dem in Script angegebenen Script-Sourcecode oder Script-Referenz hinzu. Der Thread ist zu diesem Zeitpunkt noch inaktiv.

Eine Script-Referenz wird relativ zum Pfad /clarc/Scripts angegeben. Beispielsweise /Portal/Example was dem absoluten Pfad /clarc/Scripts/Portal/Example entspricht.

Wird ein Script via Referenz angegeben, wird das Script PreCompiled und gecached und ist entsprechend ab der zweiten Ausführung schneller.

Hinweis

Ein via Referenz verwaltetes Script wird nicht über die globale C4 Refresh-Aktion aktualisiert. Hierzu wird ausschließlich die globale Einstellung "ScriptLeaseTime" herangezogen und entsprechend in diesem Rahmen automatisch aktualisiert.

Über Priority legen Sie dem neuen Thread eine Prozesspriorität im System fest. Der Standardwert entspricht tpNormal.

Folgende Werte sind für Priority möglich:

  • tpIdle

  • tpLowest

  • tpLower

  • tpNormal

  • tpHigher

  • tpHighest

  • tpTimeCritical

Name ist eine optionale Angabe eines sprechendne Bezeichners für den Thread. Ein Thread kann über den Namen oder seine interne Id (0,1,...) referenziert werden.

Im Ergebnis erhalten Sie die interne Id des Threads, beginnend bei 0.

Beispiel

Threads:= TccScriptThreads.Create; 
try  
  Threads.Add('/Portal/Example',tpHigher,'MyFirstThread);
finally  
  Threads.Free; 
end;