Procedura: utilizzare le variabili di ambiente in una compilazione

Articolo
09/12/2008

Aggiornamento: novembre 2007

Quando si generano progetti, spesso è necessario impostare le opzioni di generazione utilizzando informazioni che non si trovano nel file o nei file che compongono il progetto. Tali informazioni sono generalmente memorizzate nelle variabili di ambiente.

Riferimento alle variabili di ambiente

Tutte le variabili di ambiente sono disponibili come proprietà del file di progetto di Microsoft Build Engine (MSBuild).

Nota:
Se il file di progetto contiene una definizione esplicita di una proprietà che possiede lo stesso nome della variabile di ambiente, tale proprietà esegue l'override del valore della variabile.

Per utilizzare una variabile di ambiente in un progetto MSBuild

Fare riferimento alla variabile di ambiente come se questa fosse una variabile dichiarata nel file di progetto. Il codice riportato di seguito, ad esempio, fa riferimento alla variabile di ambiente BIN_PATH:
```
<FinalOutput>$(BIN_PATH)\MyAssembly.dll</FinalOutput>
```

Se la variabile di ambiente non è stata impostata, per specificare un valore predefinito per una proprietà è possibile utilizzare un attributo Condition.

Per specificare un valore predefinito per una proprietà

Utilizzare un attributo Condition per impostare un valore su una proprietà solo se alla proprietà non è stato assegnato alcun valore. Il codice riportato di seguito, ad esempio, imposta la proprietà ToolsPath su c:\tools solo se la variabile di ambiente ToolsPath non è stata impostata:

<ToolsPath Condition="'$(TOOLSPATH)' == ''">c:\tools</ToolsPath>

Nota:
Poiché i nomi delle proprietà non rilevano la differenza tra maiuscole e minuscole, sia $(ToolsPath) che $(TOOLSPATH) fanno riferimento alla stessa proprietà o variabile di ambiente.

Esempio

Il file di progetto riportato di seguito utilizza le variabili di ambiente per specificare il percorso delle directory.

<Project DefaultTargets="FakeBuild">
    <PropertyGroup>
        <FinalOutput>$(BIN_PATH)\myassembly.dll</FinalOutput>
        <ToolsPath Condition=" '$(ToolsPath)' == '' ">
            C:\Tools
        </ToolsPath>
    </PropertyGroup>
    <Target Name="FakeBuild">
        <Message Text="Building $(FinalOutput) using the tools at $(ToolsPath)..."/>
    </Target>
</Project>

Vedere anche

Attività

Procedura: compilare gli stessi file di origine con opzioni diverse

Concetti

MSBuild

Proprietà di MSBuild

Condividi tramite