簽出和編輯命令
讓本機檔案可寫入，並將它在工作區中的 [暫止的變更] 狀態變更為 "edit"。 Edit 是 Checkout 命令的別名。 如需詳細資訊，請參閱暫止的變更。
.gif "注意事項") 注意事項 |
|---|
除非執行簽入作業，否則您對已簽出項目所做的任何編輯都不會反映在 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 |
防止其他使用者簽入或簽出指定的檔案。 如需詳細資訊，請參閱認識鎖定類型。 鎖定選項：
|
/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