Metodo Session.FormatRecord

Il metodo FormatRecord dell'oggetto Session restituisce una stringa formattata da un modello e dai dati dei record.

Sintassi

Session.FormatRecord(
  record
)

Parametri

Registrazione

Oggetto Record obbligatorio contenente un modello e i dati da formattare. La stringa del modello deve essere impostata nel campo 0 seguito da eventuali parametri di dati a cui si fa riferimento.

Valore restituito

Questo metodo non restituisce valori.

Commenti

Il metodo FormatRecord usa il processo di formato seguente.

I parametri da formattare sono racchiusi tra parentesi quadre [ ] .. . È possibile eseguire l'iterazione delle parentesi quadre perché le sostituzioni vengono risolte dall'interno all'esterno.

Se una parte della stringa è racchiusa tra parentesi graffe { } e non contiene parentesi quadre, la parte rimane invariata, incluse le parentesi graffe.

Se una parte della stringa è racchiusa tra parentesi graffe e contiene uno o più nomi di proprietà e se vengono trovate tutte le proprietà, il testo (con le sostituzioni risolte) viene visualizzato senza le parentesi graffe. Se una delle proprietà non viene trovata, tutto il testo tra parentesi graffe e le parentesi graffe stesse viene rimosso.

Per formattare le stringhe usando il metodo FormatRecord

  1. I parametri numerici vengono sostituiti sostituendo il marcatore con il valore del campo record corrispondente, con valori mancanti o Null che non producono testo.
  2. La stringa che risulta viene elaborata sostituendo i parametri non di record con i valori corrispondenti, come illustrato nelle descrizioni seguenti.
    • Se viene rilevata una sottostringa nel formato " propertyname ", viene sostituita [ dal valore della proprietà ] .
    • Se viene trovata una sottostringa nel formato " [ %environmentvariable ", il ] valore della variabile di ambiente viene sostituito.
    • Se viene trovata una sottostringa del modulo [ # filekey, viene sostituita dal percorso completo del ] file, con il valore filekey usato come chiave nella tabella File . Il valore di filekey rimane vuoto e non viene sostituito da un percorso finché il programma di installazione non esegue l'azione [ # ] CostInitialize, l'azione FileCoste l'azione CostFinalize. Il valore di [ # filekey ] dipende dallo stato di installazione del componente a cui appartiene il file. Se il componente viene eseguito dall'origine, il valore è il percorso del percorso di origine del file. Se il componente viene eseguito in locale, il valore è il percorso del percorso di destinazione del file dopo l'installazione. Se il componente è assente, il percorso è vuoto. Per altre informazioni sul controllo dello stato di installazione dei componenti, vedere Controllo dell'installazione di funzionalità, componenti, file.
    • Se viene trovata una sottostringa nel [ formato $componentkey, viene sostituita dalla directory di installazione del componente, con il valore ] componentkey usato come chiave nella tabella Component. Il valore di componentkey rimane vuoto e non viene sostituito da una directory finché il programma di installazione non esegue l'azione [ $ ] CostInitialize, l'azione FileCoste l'azione CostFinalize. Il valore di [ $ componentkey ] dipende dallo stato di installazione del componente. Se il componente viene eseguito dall'origine, il valore è la directory di origine del file. Se il componente viene eseguito in locale, il valore è la directory di destinazione dopo l'installazione. Se il componente è assente, il valore viene lasciato vuoto. Per altre informazioni sul controllo dello stato di installazione dei componenti, vedere Controllo dell'installazione di funzionalità, componenti, file.
    • Se viene trovata una sottostringa nel formato " c ", viene sostituita dal carattere [ \ senza ulteriori ] elaborazioni. Viene mantenuto solo il primo carattere dopo la barra rovesciata. tutti gli altri elementi vengono rimossi.

Requisiti

Requisito Valore
Versione
Windows Programma di installazione 5.0 Windows Server 2012, Windows 8, Windows Server 2008 R2 o Windows 7. Windows Installer 4.0 o Windows Installer 4.5 in Windows Server 2008 o Windows Vista. Windows Programma di installazione Windows Server 2003 o Windows XP
DLL
Msi.dll
IID
IID _ ISession è definito come 000C109E-0000-0000-C000-000000000046

Vedi anche

Formattato

Tipi di dati delle colonne