Previous Topic

Book Contents

SettingsList

<SettingsList/> enumera la varie sezioni secondarie di un <Location/> e le migra tutte. Ciò permette di migrare elenchi di lunghezza arbitraria, o gruppi i cui nomi sono sconosciuti quando si scrive il pacchetto. Nella maggior parte dei casi, questo viene gestito meglio con una posizione registry/subkey, ma un <SettingsList/> è necessario se bisogna usare i valori interessati, per memorizzare i file a cui puntano, per esempio.

All'interno di <SettingsList/> sono disponibili due variabili speciali. La prima condivide il suo nome con il tag <SettingsList/> tag—%UserDefinedFunctions% nell'esempio in basso. In questo caso si riferisce al nome di ogni valore nella chiave specificata. La seconda variabile, non illustrata nell'esempio in basso, ha lo stesso nome della prima, ma con un suffisso _value, per esempio, %UserDefinedFunctions_value%. Le variabili con un suffisso _value si riferiscono a tutto ciò che è memorizzato sotto quel nome. Qui si tratta dei dati associati ad ogni chiave.

Esempio

Per memorizzare un elenco arbitrario di file memorizzati nel Registro come percorsi file, dobbiamo usare <SettingsList/>:

        <SettingsList Name="UserDefinedFunctions" Type="value">
            <Location Type="registry" SubType="subkey">
                HKCU\Software\Crunch\User Defined Functions
            </Location>

            <Setting Name="UDF" Type="filepath">
                <Location Type="registry" SubType="value">
                    HKCU\Software\Crunch\User Defined Functions\%UserDefinedFunctions%
                </Location>
            </Setting>
        </SettingsList>

Attributi

Descrizione

Valori possibili

Obbligatorio?

Tipo

Sopracosa si sta enumerando?

chiave o valore

Figli

Minimo

Massimo

<Location/>

1

Qualsiasi

<Setting/>

0

Qualsiasi