Share via

Session.FormatRecord-Methode

  • Artikel

Die FormatRecord-Methode des Session-Objekts gibt eine formatierte Zeichenfolge aus einer Vorlage und Datensatzdaten zurück.

Syntax

Session.FormatRecord(
  record
)

Parameter

record

Erforderliches Record-Objekt, das eine Vorlage und die zu formatierenden Daten enthält. Die Vorlagenzeichenfolge muss in Feld 0 festgelegt werden, ggf. gefolgt von referenzierten Datenparametern.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Bemerkungen

Die FormatRecord-Methode verwendet den folgenden Formatprozess.

Die zu formatierenden Parameter werden in eckige Klammern [..] eingeschlossen. Die eckigen Klammern können durchlaufen werden, da die Ersetzungen von innen nach außen aufgelöst werden.

Wenn ein Teil der Zeichenfolge in geschweifte Klammern { } eingeschlossen ist und keine eckigen Klammern enthält, bleibt dieser Teil einschließlich der geschweiften Klammern unverändert.

Wenn ein Teil der Zeichenfolge in geschweifte Klammern eingeschlossen ist, einen oder mehrere Eigenschaftsnamen enthält und alle Eigenschaften gefunden werden, wird der Text (mit den aufgelösten Ersetzungen) ohne die geschweiften Klammern angezeigt. Wenn keine der Eigenschaften gefunden wird, werden der gesamte Text in den geschweiften Klammern und die geschweiften Klammern selbst entfernt.

So formatieren Sie Zeichenfolgen mit der FormatRecord-Methode

  1. Die numerischen Parameter werden ersetzt, indem der Marker durch den Wert des entsprechenden Datensatzfelds ersetzt wird. Hierbei wird durch fehlende Werte oder NULL-Werte kein Text erzeugt.
  2. Die daraus resultierende Zeichenfolge wird verarbeitet, indem die Nicht-Datensatzparameter durch die entsprechenden Werte ersetzt werden, wie in den folgenden Beschreibungen angegeben.
    • Wird eine Teilzeichenfolge im Format „[propertyname]“ gefunden, wird diese durch den Wert der Eigenschaft ersetzt.
    • Wird eine Teilzeichenfolge im Format „[%environmentvariable]“ gefunden, wird der Wert der Umgebungsvariablen eingesetzt.
    • Wird eine Teilzeichenfolge im Format „[#filekey]“ gefunden, wird diese durch den vollständigen Pfad der Datei ersetzt, wobei der Wert filekey als Schlüssel in der File-Tabelle verwendet wird. Der Wert von „[#filekey]“ bleibt leer und wird erst durch einen Pfad ersetzt, wenn der Installer die Aktionen CostInitialize, FileCost und CostFinalize ausführt. Der Wert von „[#filekey]“ hängt vom Installationsstatus der Komponente ab, zu der die Datei gehört. Wenn die Komponente von der Quelle aus ausgeführt wird, entspricht der Wert dem Pfad zum Quellspeicherort der Datei. Wenn die Komponente lokal ausgeführt wird, entspricht der Wert dem Pfad zum Zielspeicherort der Datei nach der Installation. Ist die Komponente nicht vorhanden, ist der Pfad leer. Weitere Informationen zum Überprüfen des Installationszustands von Komponenten finden Sie unter Überprüfen der Installation von Features, Komponenten und Dateien.
    • Wird eine Teilzeichenfolge im Format „[$componentkey]“ gefunden, wird sie durch das Installationsverzeichnis der Komponente ersetzt. Hierbei wird der Wert componentkey als Schlüssel in der Component-Tabelle verwendet. Der Wert von „[$componentkey]“ bleibt leer und wird erst durch ein Verzeichnis ersetzt, wenn der Installer die Aktionen CostInitialize, FileCost und CostFinalize ausführt. Der Wert von „[$componentkey]“ hängt vom Installationszustand der Komponente ab. Wenn die Komponente von der Quelle aus ausgeführt wird, entspricht der Wert dem Quellverzeichnis der Datei. Wenn die Komponente lokal ausgeführt wird, entspricht der Wert dem Zielverzeichnis nach der Installation. Wenn die Komponente nicht vorhanden ist, bleibt der Wert leer. Weitere Informationen zum Überprüfen des Installationszustands von Komponenten finden Sie unter Überprüfen der Installation von Features, Komponenten und Dateien.
    • Wird eine Teilzeichenfolge der Form „[\c]“ gefunden, wird diese ohne weitere Verarbeitung durch das Zeichen ersetzt. Nur das erste Zeichen nach dem umgekehrten Schrägstrich wird beibehalten, alle übrigen werden entfernt.

Anforderungen

Anforderung Wert
Version
 Windows Installer 5.0 unter Windows Server 2012, Windows 8, Windows Server 2008 R2 oder Windows 7. Windows Installer 4.0 oder Windows Installer 4.5 unter Windows Server 2008 oder Windows Vista. Windows Installer unter Windows Server 2003 oder Windows XP
DLL
Msi.dll
IID
 IID_ISession ist definiert als 000C109E-0000-0000-C000-000000000046

Siehe auch

Formatted (Formatiert)

Spaltendatentypen