共用方式為


DeleteWorkspaceTask 工作

更新:2007 年 11 月

DeleteWorkspaceTask 工作會刪除上一個組建遺留下來的工作區。

參數

屬性

描述

TeamFoundationServerUrl

指定 Team Foundation Server URL。例如,http://MyServer:8080。

Name

指定工作區名稱。

DeleteLocalItems

指出是否要刪除工作區對應內指定的本機項目。如果 DeleteLocalItems 設定為 true,便會刪除本機項目。如果 DeleteLocalItems 設定為 false,表示不刪除本機項目。

當 CleanCompilationOutpuOnly 和 SkipInitializeWorkspace 屬性為 false 時,DeleteLocalItems 會設定為 true。

當 CleanCompilationOutpuOnly 和 SkipInitializeWorkspace 屬性為 true 時,DeleteLocalItems 會設定為 false。

備註

DeleteWorkspaceTask 工作定義於 Microsoft.TeamFoundation.Build.Tasks.VersionControl.dll 中。Microsoft.TeamFoundation.Build.targets 檔包含 DeleteWorkspaceTask 工作的執行個體 (Instance),而且 Team Foundation Build 會將它當做 AfterGet 目標的預設實作 (Implementation) 使用。您也可以透過在 TFSBuild.proj 檔中針對組建類型定義不同的 DeleteWorkspaceTask 工作執行個體 (Instance),自訂建置處理序。

Team Foundation Build 電腦上的 <root>:\Program Files\MSBuild\Microsoft\VisualStudio\TeamBuild 資料夾包含 Microsoft.TeamFoundation.Build.targets 檔。

範例

下列範例會使用 TFSBuild.proj 檔中的 DeleteWorkspaceTask 工作刪除指定的工作區。

<!-- Add the UsingTask to the top of the TFsBuild.proj file, right after the schema definition-->
<UsingTask TaskName="Microsoft.TeamFounadtion.Build.Tasks.DeleteWorkspaceTask"   AssemblyFile="$(TeamBuildRefPath)\Microsoft.TeamFoundation.Build.Tasks.VersionControl.dll" />
<!-- Add the following XML after the closing </ItemGroup>-->
<!-- and before the closing </Project>-->
</ItemGroup>
   <PropertyGroup>      <WorkspaceName>MyWorkspace</WorkspaceName>   </PropertyGroup>   <TargetName="AfterGet">      <DeleteWorkspaceTask         TeamFoundationServerUrl="http://MyTFServer.8080"         Name="$(WorkspaceName)"/>   </Target>
</Project>

下列範例會示範 Microsoft.TeamFoundation.Build.targets 檔案內所定義之 DeleteWorkspaceTask 工作的預設執行個體。

<DeleteWorkspaceTask
    Condition=" '$(CleanCompilationOutputOnly)' != 'true' " 
    TeamFoundationServerUrl="$(TeamFoundationServerUrl)"
    Name="$(WorkspaceName)"
    DeleteLocalItems="true" />

<DeleteWorkspaceTask
    Condition=" '$(CleanCompilationOutputOnly)' == 'true' "
    TeamFoundationServerUrl="$(TeamFoundationServerUrl)"
    Name="$(WorkspaceName)"
    DeleteLocalItems="false" />

請參閱

工作

HOW TO:自訂組建事件

概念

Team Foundation Build 工作

瞭解 Team Foundation Build 組態檔

其他資源

自訂 Team Foundation Build

Team Foundation Build 目標、工作和屬性