Condividi tramite


Metodo Session.FormatRecord

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

Sintassi

Session.FormatRecord(
  record
)

Parametri

Registrazione

Oggetto Record obbligatorio contenente un modello e dati da formattare. La stringa del modello deve essere impostata nel campo 0 seguita da qualsiasi parametro 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 [..]. Le parentesi quadre possono essere iterazione perché le sostituzioni vengono risolte dall'interno.

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

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

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. Stringa elaborata sostituendo i parametri non record con i valori corrispondenti, come indicato nelle descrizioni seguenti.
    • Se viene rilevata una sottostringa del modulo "[propertyname]", viene sostituita dal valore della proprietà.
    • Se viene trovata una sottostringa del modulo "[%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 la chiave file utilizzata come chiave nella tabella File. Il valore di [#filekey] rimane vuoto e non viene sostituito da un percorso finché il programma di installazione esegue l'azione CostInitialize, l'azione FileCost e 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 del modulo [$componentkey] viene sostituita dalla directory di installazione del componente, con la chiave componente valore usata come chiave nella tabella Component. Il valore di [$componentkey] rimane vuoto e non viene sostituito da una directory finché il programma di installazione esegue l'azione CostInitialize, l'azione FileCost e 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 del modulo "[\c]", viene sostituita dal carattere senza ulteriori elaborazioni. Solo il primo carattere dopo che la barra rovesciata viene mantenuta; tutto il resto viene rimosso.

Requisiti

Requisito Valore
Versione
Windows Installer 5.0 in 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 Installer in Windows Server 2003 o Windows XP
DLL
Msi.dll
IID
IID_ISession è definito come 000C109E-0000-0000-C000-000000000000046

Vedi anche

Formattato

Tipi di dati di colonna