BuildService 類別

繼承階層

System.Object
  System.ComponentModel.MarshalByValueComponent
    System.Web.Services.WebService
      Microsoft.TeamFoundation.Server.Core.WebServices.TeamFoundationWebService
        Microsoft.TeamFoundation.Build.Server.BuildWebServiceBase
          Microsoft.TeamFoundation.Build.Server.Compatibility.BuildService

命名空間：  Microsoft.TeamFoundation.Build.Server.Compatibility
組件：  Microsoft.TeamFoundation.Build.Server (在 Microsoft.TeamFoundation.Build.Server.dll 中)

語法

'宣告
<ClientServiceAttribute(ComponentName := "TeamBuild", RegistrationName := "Build",  _
    ServiceName := "BuildService", CollectionServiceIdentifier := "543cf133-319b-4c7b-800a-fafff734f291")> _
<WebServiceAttribute(Namespace := "https://schemas.microsoft.com/TeamFoundation/2005/06/Build/BuildService/03",  _
    Description := "Team Foundation Build web service")> _
Public NotInheritable Class BuildService _
    Inherits BuildWebServiceBase

[ClientServiceAttribute(ComponentName = "TeamBuild", RegistrationName = "Build", 
    ServiceName = "BuildService", CollectionServiceIdentifier = "543cf133-319b-4c7b-800a-fafff734f291")]
[WebServiceAttribute(Namespace = "https://schemas.microsoft.com/TeamFoundation/2005/06/Build/BuildService/03", 
    Description = "Team Foundation Build web service")]
public sealed class BuildService : BuildWebServiceBase

BuildService 類型會公開下列成員。

建構函式

	名稱	描述
	BuildService

回頁首

屬性

	名稱	描述
	Application	取得目前 HTTP 要求的應用程式物件。 (繼承自 WebService)。
	Container	取得元件的容器。 (繼承自 MarshalByValueComponent)。
	Context	取得目前要求的 ASP.NET HttpContext 將 HTTP 伺服器使用的所有 HTTP 特定內容封裝，以便處理 Web 要求。 (繼承自 WebService)。
	DesignMode	取得值，表示元件目前是否處於設計模式。 (繼承自 MarshalByValueComponent)。
	Server	取得目前要求的 HttpServerUtility。 (繼承自 WebService)。
	Session	取得目前要求的 HttpSessionState。 (繼承自 WebService)。
	Site	取得或設定元件的站台。 (繼承自 MarshalByValueComponent)。
	SoapVersion	取得向 XML Web Service 提出 SOAP 要求時所使用的 SOAP 通訊協定版本。 (繼承自 WebService)。
	User	取得 ASP.NET 伺服器 User 物件。可用來驗證是否授權使用者執行要求。 (繼承自 WebService)。

回頁首

方法

	名稱	描述
	AddBuildAgents
	AddBuildDefinitions	加入伺服器的 BuildDefinition 物件。如果 URI 欄位在傳送存取伺服器之前，它將會被忽略。複製組建定義可能不在相同路徑存在。因此，如果這個情況，遇到例外狀況可能會擲回。加入所有定義為可交易，如此一來，如果加入失敗，所有加入失敗。
	AddBuildQualities	將品質清單至目標 Team 專案。執行加入的使用者必須具有「EditBuildStatus」使用權限才能執行這個動作。
	CancelBuilds	取消目前在延後或作用中狀態的組建在佇列中。執行復原的使用者必須具有 Team 專案的管理組建使用權限才能順利完成。
	DeleteBuildAgents
	DeleteBuildDefinitions	刪除具有 URI 等於那些會當做陣列參數從伺服器刪除組建定義。仍然有組建與其定義，其是否已完成或已佇列並在「現用」， 「延後」或「InProgress」狀態，無法刪除。必須在移除這個定義之前刪除相關的組建。
	DeleteBuildQualities	刪除目標 Team 專案刪除指定的組建品質。若要執行此動作的使用者必須有 Team 專案" EditBuildStatus」使用權限。
	DeleteBuilds	刪除對應於指定之 URI 的組建。如果指定的組建不存在，則會以無訊息模式忽略。如果這個方法不會擲回任何例外狀況，可以假設，刪除建置組件移至好。非嚴重錯誤 (例如測試結果刪除失敗 (除了使用權限問題之外) 和置放位置存取問題記錄到事件記錄檔和未考量的錯誤。
	Dispose	釋放 MarshalByValueComponent 所使用的所有資源。 (繼承自 MarshalByValueComponent)。
	Equals	判斷指定的物件是否等於目前的物件。 (繼承自 Object)。
	EvaluateSchedules	這個方法就目前不做。其目的是要保持 BuildService webservice 活動。 它會定期每 10 分鐘由 TFSServerScheduler 服務。
	GetAffectedBuildDefinitions	判斷，如果有的話，組建定義是由所提供之伺服器項目的影響。
	GetBuildQualities	擷取針對目標 Team 專案存在的組建品質。使用者必須在目標 Team 專案" GenericRead」權限才能檢視組建品質。
	GetHashCode	做為預設雜湊函式。 (繼承自 Object)。
	GetService	取得 IServiceProvider 的實作器。 (繼承自 MarshalByValueComponent)。
	GetType	取得目前執行個體的 Type。 (繼承自 Object)。
	ProcessChangeset
	QueryBuildAgentsByUri	查詢使用 URI 清單的組建代理程式。輸出清單會是相同大小有空白索引在每個位置 URI 找不到的項目清單。
	QueryBuildDefinitionsByUri	指定之組建定義的查詢一組 URI。伺服器會傳回每一個有效 URI 的定義陣列中。
	QueryBuildGroups	查詢符合輸入 BuildItemSpec 物件項目的伺服器。如果 URI 是未知的，則這個方法可用來將路徑尋找項目。
	QueryBuildQueue	查詢指定的組建佇列一組代理程式和定義的規格。
	QueryBuildQueueById	依 ID. 查詢已佇列組建。輸出清單會是相同大小有 Null 索引鍵與不存在的輸入對應的項目清單。
	QueryBuilds	將 BuildDetailSpec 物件的陣列，表示此方法傳回 BuildQueryResult 物件結果清單相同大小的輸入陣列。如果找不到符合的項目， BuildQueryResult 物件會有空白清單。
	QueryBuildsByUri	查詢組建而不是由路徑的 URI 所提供的選項。單一 BuildQueryResult 物件從查詢傳回，與 BuildDetail 清單長度和輸入 URI 陣列相同。如果特定 URI 不符合任何組建，在產生的 BuildDetail 清單的對應的索引會是空的。從查詢傳回的資料量傳遞選項參數來控制的。
	QueueBuild	使用提供的要求，嘗試將組建排入佇列。如果佇列成功，已佇列組建清單傳回。佇列組建的 QueueId 可能是用來在項目最新查詢輪詢。如果組建只有一個在佇列和狀態時的佇列設為「Active」。建置會立即啟動。
	StopBuilds	停止與提供的 URI 進行中的組建。如果建置已經完成，則會忽略並考慮成功。執行這個呼叫的使用者必須具有 AdministerBuild 權限停止正在進行的所有 Team 專案。
	ToString	傳回 String，其中可能含有 Component 的名稱。這個方法不應該被覆寫。 (繼承自 MarshalByValueComponent)。
	UpdateBuildAgents
	UpdateBuildDefinitions
	UpdateBuildInformation
	UpdateBuilds	使用提供的資訊的組建詳細資料。使用者必須擁有在 Team 專案的 AdministerBuild 權限包含組建才能執行這個動作。
	UpdateQueuedBuilds	使用提供的資訊的已佇列組建。使用者必須擁有在 Team 專案的 AdministerBuild 權限包含已佇列組建才能執行這個動作。這個方法是全部或 Nothing，表示所有更新作業或無這些工作。變更組建的延後的旗標可能造成啟動。因此，，如果組建開始時， QueuedBuild 物件的建置屬性會設為。

回頁首

事件

	名稱	描述
	Disposed	加入事件處理常式來接聽 (Listen) 元件上的 Disposed 事件。 (繼承自 MarshalByValueComponent)。

回頁首

執行緒安全

這個類型的任何 Public static (在 Visual Basic 中為 Shared) 成員都是安全執行緒。不保證任何執行個體成員是安全執行緒。

請參閱

參考

Microsoft.TeamFoundation.Build.Server.Compatibility 命名空間