HOW TO：選取要建置的檔案

發行項
03/01/2013

建置 (Build) 內含許多檔案的專案時，您可以在專案檔中分別列出這些檔案，或者使用萬用字元，併入某一目錄或巢狀目錄集內的所有檔案。

指定輸入

項目表示建置的輸入。如需項目的詳細資訊，請參閱 MSBuild 項目。

若要加入建置的檔案，這些檔案必須置於 MSBuild 專案檔的項目清單中。若要在項目清單中加入多重檔案，您可以個別併入檔案，或使用萬用字元一次併入許多檔案。

若要個別宣告項目

請以下列方式使用 Include 屬性 (Attribute)：

<CSFile Include="form1.cs"/>

-或-

<VBFile Include="form1.vb"/>

注意事項

如果項目集合中的項目不在專案檔所在的目錄中，您必須指定完整] 或 [相對路徑項目。例如：Include="..\..\form2.cs"。

注意事項
如果項目集合中的項目不在專案檔所在的目錄中，您必須指定完整] 或 [相對路徑項目。例如：Include="..\..\form2.cs"。

若要宣告多個項目

請以下列方式使用 Include 屬性 (Attribute)：

<CSFile Include="form1.cs;form2.cs"/>

-或-

<VBFile Include="form1.vb;form2.vb"/>

使用萬用字元指定輸入

您也可以使用萬用字元，以遞迴方式併入子目錄中的所有檔案或特定檔案，做為建置的輸入。如需萬用字元的詳細資訊，請參閱 MSBuild 項目

以下範例所依據的專案含有位於下列目錄和子目錄中的圖形檔，專案檔則位於 Project 目錄。

Project\Images\BestJpgs

Project\Images\ImgJpgs

Project\Images\ImgJpgs\Img1

若要併入 Image 目錄和子目錄中的所有 .jpg 檔案

請使用下列 Include 屬性：

Include="Images\**\*.jpg"

若要併入開頭為 "img" 的所有 .jpg 檔案

請使用下列 Include 屬性：

Include="Images\**\img*.jpg"

若要併入目錄中檔名結尾為 "jpgs" 的所有檔案

使用下列其中一個 Include 屬性：

Include="Images\**\*jpgs\*.*"

-或-

Include="Images\**\*jpgs\*"

將項目傳遞至工作

在專案檔的工作中，您可以使用 @() 標記法指定整個項目清單做為建置的輸入。無論分別列出檔案或使用萬用字元，都可以使用這個標記法。

若要使用所有 Visual C# 或 Visual Basic 檔案做為輸入

請以下列方式使用 Include 屬性：

<CSC Sources="@(CSFile)">...</CSC>

-或-

<VBC Sources="@(VBFile)">...</VBC>

注意事項
您必須在項目中使用萬用字元指定建置的輸入，不能在 Csc 或 Vbc 等 MSBuild 工作中使用 Sources 屬性來指定輸入。下列範例在專案檔中無效： <CSC Sources="*.cs">...</CSC>

您必須在項目中使用萬用字元指定建置的輸入，不能在 Csc 或 Vbc 等 MSBuild 工作中使用 Sources 屬性來指定輸入。下列範例在專案檔中無效：

範例

在下列程式碼中，示範了個別併入所有輸入檔的專案：

<Project DefaultTargets="Compile"
    xmlns="https://schemas.microsoft.com/developer/msbuild/2003" >
    <PropertyGroup>
        <Builtdir>built</Builtdir>
    </PropertyGroup>

    <ItemGroup>
        <CSFile Include="Form1.cs"/>
        <CSFile Include="AssemblyInfo.cs"/>

        <Reference Include="System.dll"/>
        <Reference Include="System.Data.dll"/>
        <Reference Include="System.Drawing.dll"/>
        <Reference Include="System.Windows.Forms.dll"/>
        <Reference Include="System.XML.dll"/>
    </ItemGroup>

    <Target Name="PreBuild">
        <Exec Command="if not exist $(builtdir) md $(builtdir)"/>
    </Target>

    <Target Name="Compile" DependsOnTargets="PreBuild">
        <Csc Sources="@(CSFile)"
            References="@(Reference)"
            OutputAssembly="$(builtdir)\$(MSBuildProjectName).exe"
            TargetType="exe" />
    </Target>
</Project>

下列程式碼範例使用萬用字元併入所有 .cs 檔案：

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

    <PropertyGroup>
        <builtdir>built</builtdir>
    </PropertyGroup>

    <ItemGroup>
        <CSFile Include="*.cs"/>

        <Reference Include="System.dll"/>
        <Reference Include="System.Data.dll"/>
        <Reference Include="System.Drawing.dll"/>
        <Reference Include="System.Windows.Forms.dll"/>
        <Reference Include="System.XML.dll"/>
    </ItemGroup>

    <Target Name="PreBuild">
        <Exec Command="if not exist $(builtdir) md $(builtdir)"/>
    </Target>

    <Target Name="Compile" DependsOnTargets="PreBuild">
        <Csc Sources="@(CSFile)"
            References="@(Reference)"
            OutputAssembly="$(builtdir)\$(MSBuildProjectName).exe"
            TargetType="exe" />
    </Target>
</Project>

共用方式為