Präprozessor-Direktiven zur Verarbeitung von Konfigurationsdateien


 Produkt(e):MicroStation
 Version(en):08.11.xx.xxx  oder 10.xx.xx.xxx
 Umgebung:N\A
 Produktbereich:Konfiguration
 Produktunterbereich:Allgemein

Wenn MicroStation gestartet wird, verarbeitet es eine Vielzahl von Konfigurationsdateien, die sehr spezifische Anweisungen enthalten. Diese Anweisungen enthalten Codestücke, die als Präprozessor-Direktiven bezeichnet werden und die Art und Weise steuern, in der MicroStation diese Dateien verarbeitet. In diesem Artikel erhalten Sie eine kleine Führung, damit Sie verstehen, was hinter den Kulissen vor sich geht.

Präprozessor-Direktiven beginnen mit einem % und Sie finden viele hervorragende Beispiele in der Datei msconfig.cfg.

HINWEIS: Das Öffnen und Anschauen dieser wichtigen Konfigurationsdatei ist eine Sache... sie zu bearbeiten ist etwas ganz anderes und kann sehr leicht dazu führen, dass MicroStation überhaupt nicht geladen wird. Seien Sie beim Umgang mit dieser Datei äußerst vorsichtig.

%include [Dateiname oder Variable]
Der %include-Prozessor weist MicroStation an, die angegebene Datei oder Variable zu verarbeiten.
So finden Sie z. B. in mslocal.cfg eine Zeile, die MicroStation anweist, msconfig.cfg zu verarbeiten, wie unten gezeigt.



%if-Ausdruck
 Diese Anweisung führt nur dann weitere Codezeilen aus, bis sie ein %endif erreicht, wenn der Ausdruck wahr ist.
 Die verfügbaren Ausdrücke sind:
     defined (Datei oder Variable) Wahr, wenn die Variable definiert ist
     exists (Datei oder Variable) Wahr, wenn die Variable existiert.
    || Logisches ODER
     && Logisches UND
     ! Negieren
    ( ) Gruppierung

Zum Beispiel:
%if defined (Datei oder Variable)
Wenn die Variable wahr ist, dann werden weitere Codezeilen ausgeführt.



Zum Beispiel:
%if exists (Datei oder Variable)
Wenn die Datei oder Variable existiert, dann wird die Verarbeitung fortgesetzt.



%else
Diese Direktive gibt an, dass MicroStation mit der Ausführung von Code fortfahren soll, wenn der letzte %if-Ausdruck falsch ist.

%elif-Ausdruck
 In diesem Fall sollte MicroStation die folgenden Codezeilen ausführen, wenn das vorherige %if falsch war und der Ausdruck wahr ist.

%endif
Dies ist das Ende eines bedingten Blocks. Alle Codeabschnitte, die mit %if beginnen, enden mit einem %endif:



%Fehlerzeichenfolge
Mit diesem Fun-Befehl wird die in der Zeichenkette angegebene Meldung gedruckt und MicroStation anschließend beendet.

%undef Variablenname
Mit dieser Direktive wird die durch Variablenname angegebene Konfigurationsvariable undefiniert und gelöscht. Um die Variable mit einer Übersetzung von NULL definiert zu lassen, verwenden Sie Variablenname = [Leerzeichen]

%level Wert
 Dies gibt den Level der Verarbeitung an, und viele Beispiele dafür finden Sie in msconfig.cfg

%lock Variablenname
Diese sehr mächtige Direktive sperrt die benannte Konfigurationsvariable mit ihrem aktuellen Wert. Der folgende Ausschnitt stammt zum Beispiel aus der mitgelieferten Datei civil.pcf und zeigt deutlich, wie MS_DESIGNSEED definiert und dann gesperrt wird.



Sehen Sie hierzu auch

X

Anderssprachige Quellen

https://bentleysystems.service-now.com/community?id=kb_article_view&sysparm_article=KB0055938