共用方式為


使用 Team Foundation 的用戶端物件模型,擴充工作項目追蹤的功能

您可以用程式設計方式建立,變更和尋找 Bug、工作和其他工作項目類型的型別可以使用工作項目追蹤物件模型。若要存取工作項目,您必須先連接到 Visual Studio Team Foundation Server從主控台應用程式連接到 Team Foundation Server,如中所述。

一般工作

使用 Team Foundation 的用戶端物件模型來建立工作項目

使用 Team Foundation 的用戶端物件模型來編輯和儲存工作項目

查詢 Bug、工作和其他工作項目

WorkItemStore.GetWorkItem

(Code Gallery) 列舉已儲存的查詢

(CodePlex) TFS 工作項目追蹤的自訂控制項

使用 Team Foundation 的用戶端物件模型,為不同的工作項目類型撰寫程式碼

執行緒考量

如果您的應用程式的多個執行緒,則應該建立每個執行緒的 WorkItemStore 。如果執行緒共用 WorkItemStore,應用程式就會很好地擴充。只要 WorkItemStore 和相關物件處理, WorkItemStore 共用的執行緒會被封鎖。

初始化 WorkItemStore 的成本會很明顯。因此,您應該使用物件和保留它的參考在執行緒的存留期。例如,在中,如果您要追蹤工作項目類型使用物件模型中 ASP.NET 應用程式,可以在使用者工作階段中應該快取 WorkItemStore 物件或建立執行緒集區和每一個執行緒使用單一 WorkItemStore 物件。

Metadata

工作項目資料庫包含說明工作項目類型、欄位、規則、表單和其他資訊類型有關的一組中繼資料的工作項目類型如何設定並套用到每個 Team 專案。WorkItemStore 取得和使用的本機快取中繼資料。變更中繼資料,當任何一個項目都會更新。例如,在中,如果值加入至欄位的允許值的清單,中繼資料的另一個版本建立。用於追蹤工作項目的用戶端物件模型驗證您的 WorkItemStore 使用中繼資料的最新版本。系統會執行這個驗證,每當您呼叫會導致來回存取伺服器,例如 WorkItemStore.QueryWorkItem.Save的方法。如果具有中繼資料的較新版本,系統會更新中繼資料 WorkItemStore.MetadataChanged 接著會引發事件。

如果您的程式碼受到變更中繼資料的影響,您必須在程式碼中回應這個事件。例如,程式碼會顯示工作項目表單必須回應這個事件,讓表單的最新版本出現。

您的程式碼可以提示 WorkItemStore 其執行個體檢查更新本機中繼資料快取藉由呼叫 WorkItemStore.SyncToCache。例如,在中,如果您的應用程式使用多個物件, WorkItemStore ,在收到 WorkItemStore.MetadataChanged 事件,您的程式碼可以使用 WorkItemStore.SyncToCache 提示 WorkItemStore 物件使用中繼資料快取的更新版本。

您的程式碼可以要求它的執行個體 WorkItemStore 檢查伺服器的更新中繼資料是透過呼叫 WorkItemStore.RefreshCache

其他資源

擴充 Team Foundation 的功能

(Code Gallery) 工作項目範例

Microsoft.TeamFoundation.WorkItemTracking.Client.WorkItemStore

Microsoft.TeamFoundation.WorkItemTracking.Client.WorkItem