共用方式為


檢視命令 (Team Foundation 版本控制)

Azure DevOps Services |Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 |Visual Studio 2022

Team Foundation 版本控制 (TFVC) view 命令會擷取特定版本的檔案、將它儲存在電腦上的暫存資料夾中,並加以顯示。

先決條件

若要使用 view 命令,請將 Read 權限設定為 Allow。 如需詳細資訊,請參閱 預設 TFVC 權限

語法

tf view [/collection:<team-project-collection-url>] [/console] [/recursive] [/output:<local-file>]
[/shelveset:<shelveset-name>[;<owner>]] [/noprompt] <item-spec> 
[/version:<version-spec>] [/login:<username>,[<password>]]

參數

下列各節說明 view 命令的自變數和選項。

參數

自變數

描述

<team-project-collection-url>

提供專案集合的 URL,其中包含您想要擷取相關信息的特定檔案版本,例如,https://myserver:8080/tfs/DefaultCollection

<shelveset-name> [:<owner>]

識別擱置集。 選擇性 <owner> 自變數可用來指定目前使用者未擁有的擱置集。

<item-spec>

識別要擷取的檔案或資料夾。 如需 TFVC 如何剖析 <item-spec> 自變數以判斷哪些專案在範圍內的詳細資訊,請參閱 使用 Team Foundation 版本控制命令 - 使用選項來修改命令如何

注意

您可以指定多個 <item-spec> 自變數。

<version-spec>

提供 /version 選項的 C3 等值。 如需 TFVC 如何剖析版本規格以判斷其範圍內哪些專案的詳細資訊,請參閱 使用 Team Foundation 版本控制命令

<username>

提供值給 [/login] 選項。 您可以將此值指定為 DOMAIN\<username><username>

<password>

提供值給 [/login] 選項。

<local-file>

提供輸出檔案資料夾的路徑。

選項

選項

描述

/console

指定應該將檔案輸出導向主控台。 如果您想要使用主控台重新導向將檔案寫入磁碟,但使用與版本設定專案不同的名稱或位置,這個選項會很有用。

/recursive

檢視指定目錄和任何子目錄中的所有專案。

/shelveset

依名稱指定擱置集。

/noprompt

指定當您在符合多個檔案的 <item-spec> 自變數中包含通配符運算式時,TFVC 不應該在顯示每個檔案之前提示您。

/version

指定要開啟以供檢視的檔案版本。 如果您省略此選項,view 擷取最新的 Azure DevOps 伺服器版本。

/collection

指定專案集合。

/login

指定要向 Azure DevOps 驗證使用者的使用者名稱和密碼。

/output

將檔案輸出至本機資料夾,而不是叫用 Windows 殼層來開啟檔案。

言論

tf 命令行公用程式的 view 命令會從 Azure DevOps 伺服器擷取檔案的唯讀複本、將檔案儲存在電腦上的暫存資料夾中,並顯示檔案內容。 除非您指定特定版本,否則 TFVC 會從 Azure DevOps 伺服器擷取最新版本的檔案。

view 命令不會將檔案新增至您的工作區或取出檔案。如需如何取得檔案的 Azure DevOps 伺服器版本並簽出的詳細資訊,請參閱 Get 命令簽出和編輯命令

您可以使用 difference 命令來檢視檔案兩個版本之間的差異。 如需詳細資訊,請參閱 Difference 命令

如需如何使用 tf 命令行公用程式的詳細資訊,請參閱 使用 Team Foundation 版本控制命令

輸出選項

  • 根據預設,TFVC 會在與文件類型相關聯的查看器中顯示檔案的內容。

  • 如果您包含 /console 選項,TFVC 會將檔案的內容列印至命令主控台。 同樣地,如果 TFVC 找不到您所指定檔案類型的查看器,它會將檔案內容列印至命令控制台。

  • 您可以使用 |\>,將檔案的內容重新導向至標準輸出。 此選項可讓您將檔案儲存至另一個檔案,或將它傳遞給另一個程式以進行後續處理。

例子

下列範例會顯示最新版本的檔案 314.cs

c:\projects>tf view 314.cs

下列範例會顯示已簽入變更集 1999 的 314.cs 版本:

c:\projects>tf view /version:C1999 314.cs

下列範例會擷取第 5 版的 314.cs,並將它寫入檔案 314.old

c:\projects>tf view /version:5 314.cs > 314.old

下列範例會顯示符合通配符表達式 *.cs之每個檔案的最新版本:

c:\projects>tf view *.cs