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

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

注意事項注意事項

如果您想要自訂工作項目類型,請參閱常見的自訂區域 [重新導向]

一般工作

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

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

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

WorkItemStore.GetWorkItem

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

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

執行緒考量

如果您的應用程式進行多執行緒處理,則應該會為每個執行緒建立 WorkItemStore。 如果執行緒共用 WorkItemStore,則不會適當地調整應用程式。 只要處理 WorkItemStore 和相關物件,就會封鎖共用 WorkItemStore 的所有其他執行緒。

初始化 WorkItemStore 的成本很高。 因此,您應該初始化物件,並在執行緒存留期間保留該物件的參考。 例如,如果您在 ASP.NET 應用程式中使用用於追蹤工作項目的物件模型,則應該在使用者工作階段中快取 WorkItemStore 物件,或建立執行緒集區,並針對每個執行緒使用單一 WorkItemStore 物件。

中繼資料

工作項目資料庫包含一組中繼資料來描述工作項目、欄位、規則和表單類型,以及有關如何在每個 Team 專案中設定和使用工作項目類型的其他資訊。 WorkItemStore 會取得和使用該中繼資料的本機快取。 只要更新其中任何一個項目,就會變更中繼資料。 例如,如果將值加入至允許的欄位值清單,則會建立另一個版本的中繼資料。 用於追蹤工作項目的用戶端物件模型會驗證您的 WorkItemStore 使用最新版本的中繼資料。 只要您呼叫可導致反覆存取伺服器的方法 (例如 WorkItemStore.QueryWorkItem.Save),系統就會執行這項驗證。 如果有更新版本的中繼資料,則系統會取得更新過的中繼資料,然後引發 WorkItemStore.MetadataChanged 事件。

如果變更中繼資料會影響您的程式碼,則您的程式碼必須回應此事件。 例如,可顯示工作項目表單的程式碼必須回應此事件,以顯示最新版本的表單。

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

您的程式碼可以透過呼叫 WorkItemStore.RefreshCache,來提示其 WorkItemStore 執行個體檢查伺服器中是否有更新過的中繼資料。

其他資源

擴充 Team Foundation 的功能

WorkItemStore

WorkItem