分享方式:


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

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

Visual Studio 2019 |Visual Studio 2022

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

必要條件

若要使用 view 命令,您必須將 [讀取 ] 權限設定為 [允許]。 如需詳細資訊,請參閱 預設 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 自變數和選項。

引數

Argument

說明

<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>

提供 選項的值,例如 C3/version。 如需 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 殼層來開啟檔案。

備註

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

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

您可以使用 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