BuildService 類別

繼承階層架構

System.Object
  System.ComponentModel.MarshalByValueComponent
    System.Web.Services.WebService
      Microsoft.TeamFoundation.Framework.Server.Alm.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 中)

語法

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

[WebServiceAttribute(Namespace = "https://schemas.microsoft.com/TeamFoundation/2005/06/Build/BuildService/03", 
    Description = "Team Foundation Build web service")]
[ClientServiceAttribute(ComponentName = "TeamBuild", RegistrationName = "Build", 
    ServiceName = "BuildService", CollectionServiceIdentifier = "543cf133-319b-4c7b-800a-fafff734f291")]
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 等同於這些會當做陣列參數從伺服器刪除組建定義。還有組建與其定義，它們是否已完成或已佇列並在 Active Postponed 「， 「或「InProgress 狀態，所以無法刪除。必須在移除該定義之前刪除相關的組建。
	DeleteBuildQualities	刪除目標 Team 專案之指定的組建品質。執行動作的使用者必須將 Team 專案的" EditBuildStatus 的使用權限。
	DeleteBuilds	刪除對應於指定之 URI 的組建。如果指定的組建 (Build) 不存在，則會自動忽略。如果這個方法並不會擲回任何例外狀況，可以假設，刪除的組建組件移至好。非嚴重錯誤 (例如測試結果刪除相關的失敗 (除了允許問題之外) 和置放位置存取問題記錄至事件記錄檔和未考量的錯誤。
	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. 查詢已佇列組建輸出清單會是與相同的空間索引與不存在的項目對應的輸入清單。
	QueryBuilds	將陣列 [BuildDetailSpec] 物件，這個方法會傳回物件 [BuildQueryResult] 結果清單與相同型別的陣列。如果找不到相符的項目， [BuildQueryResult] 物件會將空白清單。
	QueryBuildsByUri	依 URI 的查詢組建而不是具有所提供之選取的路徑。單一 [BuildQueryResult] 物件從查詢傳回，以 BuildDetail 清單與輸入 URI 陣列的長度。如果特定的 URI 不符合任何組建，在產生的 BuildDetail 清單中對應的索引會是空的。從查詢傳回的資料量藉由選取參數進行控制。
	QueueBuild	使用提供的要求，嘗試將組建排入佇列。如果佇列成功，已佇列組建的清單傳回。已佇列組建的 QueueId 可以用來執行項目的最新查詢輪詢。如果組建僅是在佇列和狀態時的佇列設為「作用中」。建置會立即開始。
	StopBuilds	停止具有提供之 URI 的正在進行中的組建。如果組建已完成，則會忽略並考慮成功。執行呼叫的使用者必須擁有權限。AdministerBuild 停止所建立的所有 Team 專案。
	ToString	傳回 String，其中可能含有 Component 的名稱。這個方法不應該被覆寫。 (繼承自 MarshalByValueComponent)。
	UpdateBuildAgents
	UpdateBuildDefinitions
	UpdateBuildInformation
	UpdateBuilds	更新使用所提供的資訊的組建詳細資料。使用者必須在包含組建來執行動作的 Team 專案 AdministerBuild 的使用權限。
	UpdateQueuedBuilds	更新使用所提供的資訊的已佇列組建。使用者必須在包含已佇列組建來執行動作的 Team 專案 AdministerBuild 的使用權限。方法是所有或 Nothing，表示所有更新工作或未他們自己的工作。變更組建的延後的旗標可讓它啟動。因此， [QueuedBuild] 物件的 [Build] 屬性，如果組建開始時，會設定為。

回頁首

事件

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

回頁首

執行緒安全

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

請參閱

參考

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