參考專案檔的名稱或位置

  • 發行項

您可以在專案檔中使用專案的名稱或位置，而不需建立自己的屬性。 MSBuild 提供保留屬性，來參考專案檔名稱和其他專案相關的屬性。 如需保留屬性的詳細資訊，請參閱 MSBuild 保留和已知屬性。

使用專案屬性

MSBuild 提供一些保留屬性，讓您不必每次定義就能在專案檔中加以使用。 例如，保留的屬性 MSBuildProjectName 提供專案檔名的參考。 保留的屬性 MSBuildProjectDirectory 提供專案檔案位置的參考。

使用專案屬性

  • 使用 $() 標記法來參考專案檔中的屬性，就像您使用其他屬性一樣。 例如：

    <CSC Sources = "@(CSFile)"
    OutputAssembly = "$(MSBuildProjectName).exe"/>
</CSC>

    使用保留屬性的一個優點是，會自動併入對專案檔名所做的任何變更。 當您下一次建置專案時，輸出檔將具備新名稱，而您不需採取任何進一步動作。

    如需在檔案或專案參考中使用特殊字元的詳細資訊，請參閱 MSBuild 特殊字元。

注意

您無法在專案檔中重新定義保留的屬性。

範例 1

下列範例專案檔會參考專案名稱做為保留的屬性，來指定輸出的名稱。

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003"
    DefaultTargets = "Compile">

    <!-- Specify the inputs -->
    <ItemGroup>
        <CSFile Include = "consolehwcs1.cs"/>
     </ItemGroup>
    <Target Name = "Compile">
        <!-- Run the Visual C# compilation using
        input files of type CSFile -->
        <CSC Sources = "@(CSFile)"
            OutputAssembly = "$(MSBuildProjectName).exe" >
            <!-- Set the OutputAssembly attribute of the CSC task
            to the name of the project -->
            <Output
                TaskParameter = "OutputAssembly"
                ItemName = "EXEFile" />
        </CSC>
        <!-- Log the file name of the output file -->
        <Message Text="The output file is @(EXEFile)"/>
    </Target>
</Project>

範例 2

下列範例專案檔使用 MSBuildProjectDirectory 保留屬性，在專案檔案位置中建立檔案的完整路徑。

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">

    <!-- Build the path to a file in the root of the project -->
    <PropertyGroup>
        <NewFilePath>$([System.IO.Path]::Combine($(MSBuildProjectDirectory), `BuildInfo.txt`))</NewFilePath>
    </PropertyGroup>
</Project>

此範例會使用屬性函式語法來呼叫靜態 .NET Framework 方法 System.IO.Path.Combine。

相關內容