共用方式為


簽出和編輯命令

讓本機檔案可寫入,並將它在工作區中的 [暫止的變更] 狀態變更為 "edit"。 EditCheckout 命令的別名。 如需詳細資訊,請參閱暫止的變更

注意事項注意事項

   除非執行簽入作業,否則您對已簽出項目所做的任何編輯都不會反映在 Team Foundation 版本控制伺服器中。 如需詳細資訊,請參閱 簽入暫止的變更

必要的使用權限

若要使用 checkout 命令,[簽出] 權限必須設定為 [允許],而且您必須是工作區 (Workspace) 的擁有人或是將全域 [管理工作區] 權限設定為 [允許]。 同樣地,如果使用 /lock 選項並使用 none 以外的值,則必須將 [鎖定] 權限設定為 [允許]。 如需詳細資訊,請參閱Team Foundation Server 使用權限

tf checkout [/lock:(none|checkin|checkout)] [/recursive] 

[/type:encoding] itemspec [/login:username,[password]]

參數

引數

描述

encoding

提供 /type 選項的值。 選擇包括下列各項:Text,目前 Windows 編碼方式 (在 US 系統上為 Windows-1252) 或 Unicode (以位元組順序標記 (BOM) 為基礎) 的別名;Binary;以及 Windows 作業系統所支援的所有其他檔案編碼方式。 您也可以使用 Auto 自動偵測類型。 如需詳細資訊,請參閱管理檔案類型

itemspec

指定一或多個要簽出的檔案。 您可以在這裡使用萬用字元。

username

提供 /login 選項的值。 您可以將使用者名稱值指定成網域\ 使用者名稱或使用者名稱的格式。

選項

描述

/type

手動覆寫 Team Foundation 與指定檔案有關聯的檔案編碼方式。

/recursive

簽出目前的目錄或目前目錄的所有子資料夾中符合 itemspec 的所有檔案。

/lock

防止其他使用者簽入或簽出指定的檔案。 如需詳細資訊,請參閱認識鎖定類型

鎖定選項:

  • None

    預設值。 沒有套用任何鎖定。 如果指定的檔案已遭鎖定,None 選項就會移除之。

  • Checkin

    其他使用者可以簽出指定的項目,但除非解除鎖定,否則他們無法將修訂簽入鎖定的檔案。 如果有任何其他的使用者鎖定了任一指定的項目,鎖定作業就會失敗。

  • Checkout

    防止其他使用者簽出任一指定項目,除非鎖定釋出。 如果有任何其他的使用者鎖定了任一指定的項目,鎖定作業就會失敗。

/login

指定使用者名稱和密碼,以便透過 Visual Studio Team Foundation Server 驗證使用者。

備註

checkout 命令的預設行為是由是否已啟用 [簽出時取得項目最新的版本] 設定來決定。 如需如何檢視或變更此設定的詳細資訊,請參閱 啟用 Team Foundation 版本控制以在簽出時取得最新的檔案

如果啟用 [簽出時取得項目最新的版本],則 checkout 命令的行為會與 Visual SourceSafe 的簽出行為類似。 如果項目的最新版本並非位於您的工作區中,Team Foundation 會從 Team Foundation Server 取得最新的版本,並將其複製到您的工作區中。 如果工作區內存在舊版的相同項目,則會以最新版本覆寫舊版項目。

如果停用 [簽出時取得項目最新的版本],則 Team Foundation 不會在簽出作業期間取得最新的 Team Foundation 版本控制伺服器版本。 而是將目前的工作區版本設為可寫入。 如需詳細資訊,請參閱取得 Team 專案的原始檔

您可以使用 tf edit 當做 checkout 的別名。

根據預設,多位使用者可以同時簽出相同的版本控制項目。 使用 tf 簽出其他工作區內具有暫止變更的項目時,有關那些其他變更性質的資訊會列印在命令列中。 在大部分的共同開發環境中,您的工作區內所進行的變更不太可能與其他工作區內的暫止變更產生合併衝突 (反之亦然)。 Team Foundation 可讓您自動解決實際發生的大部分衝突。 對於無法自動解決的衝突,您可以使用 Resolve 命令放心決定要保存您或由其他使用者開始時所做的變更。 如果擔心其他使用者可能會在其工作區中進行與您的暫止變更相衝突的變更,可以使用 Status 命令監視其他的工作區是否有新套用的變更, 或者使用 Lock 命令防止其他使用者簽出或簽入,直到您已簽入自己的變更並解除其鎖定為止。 最佳作法是謹慎使用 lock 命令,並通知小組組員進行鎖定的原因,以及準備何時移除鎖定。

如需如何尋找 tf 命令列公用程式的詳細資訊,請參閱 Tf 命令列公用程式命令

範例

下列範例會將 314.cs 設為可寫入磁碟,並將其加入至工作區的暫止變更清單。

c:\pi> tf checkout 314.cs

下列範例簽出 314.cs 和 271.cs。

c:\pi>tf checkout 314.cs 271.cs

下列範例會簽出 page.xsl,並將 Team Foundation 檔案類型的編碼屬性變更為文字。 Text 是目前 Windows 編碼方式 (例如 Windows-1252) 的別名。

c:\pi>tf checkout /type:text page.xsl

請參閱

工作

簽出和編輯版本控制的項目

參考

Get 命令

Checkin 命令

Unshelve 命令

概念

認識鎖定類型

Team Foundation 簽出設定

其他資源

Tf 命令列公用程式命令