BuildWebService 類別

繼承階層架構

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.BuildWebService

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

語法

'宣告
<ClientServiceAttribute(ComponentName := "TeamBuild", RegistrationName := "Build",  _
    ServiceName := "BuildService3", CollectionServiceIdentifier := "427febc8-f703-482b-9f79-bfe1bb4631bc")> _
<WebServiceAttribute(Namespace := "https://schemas.microsoft.com/TeamFoundation/2005/06/Build/BuildService/03",  _
    Description := "Team Foundation Build web service")> _
Public NotInheritable Class BuildWebService _
    Inherits BuildWebServiceBase

[ClientServiceAttribute(ComponentName = "TeamBuild", RegistrationName = "Build", 
    ServiceName = "BuildService3", CollectionServiceIdentifier = "427febc8-f703-482b-9f79-bfe1bb4631bc")]
[WebServiceAttribute(Namespace = "https://schemas.microsoft.com/TeamFoundation/2005/06/Build/BuildService/03", 
    Description = "Team Foundation Build web service")]
public sealed class BuildWebService : BuildWebServiceBase

BuildWebService 型別會公開下列成員。

建構函式

	名稱	說明
	BuildWebService

回頁首

屬性

	名稱	說明
	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)。

回頁首

方法

	名稱	說明
	AddBuildDefinitions	將物件加入至伺服器的 [BuildDefinition] 物件。如果 URI 欄位在傳送輸入至伺服器之前，則會被忽略。複製組建定義無法在相同的路徑存在。因此，如果已設定，則會發生例外狀況，可能會擲回。將所有定義都是可異動的，因此，如果某個將失敗，那麼將會失敗。
	AddBuildQualities	將品質清單加入至目標 Team 專案。執行累加的使用者必須具有" EditBuildStatus 的使用權限才能執行這個動作。
	AddProcessTemplates
	CreateTeamProjectComponents	會取得所需的 Team 專案中的元件。
	DeleteBuildDefinitions	刪除具有 URI 等同於這些會當做陣列參數從伺服器刪除組建定義。還有組建與其定義，它們是否已完成或已佇列並在 Active Postponed 「， 「或「InProgress 狀態，所以無法刪除。必須在移除該定義之前刪除相關的組建。
	DeleteBuildQualities	刪除目標 Team 專案之指定的組建品質。執行動作的使用者必須將 Team 專案的" EditBuildStatus 的使用權限。
	DeleteBuilds	刪除對應於指定之 URI 的組建。如果指定的組建 (Build) 不存在，則會自動忽略。如果這個方法並不會擲回任何例外狀況，則可以假設，刪除的組建組件移至好。非嚴重錯誤 (例如測試結果刪除失敗的其他的使用權限問題和置放位置存取問題就是記錄至事件記錄檔和不會視為錯誤。
	DeleteProcessTemplates
	DestroyBuilds	終結對應於指定之 URI 的組建。如果指定的組建 (Build) 不存在，則會自動忽略。
	Dispose	釋放 MarshalByValueComponent 所使用的所有資源。 (繼承自 MarshalByValueComponent)。
	Equals	判斷指定的物件是否等於目前物件。 (繼承自 Object)。
	GetAffectedBuildDefinitions	判斷，如果有的話，組建定義都會受到所提供之伺服器項目的影響。
	GetBuildQualities	擷取之前為目標 Team 專案存在的組建品質。使用者必須擁有在目標 Team 專案的" GenericRead 權限才能檢視組建品質。
	GetHashCode	做為特定型別的雜湊函式。 (繼承自 Object)。
	GetService	取得 IServiceProvider 的實作器。 (繼承自 MarshalByValueComponent)。
	GetType	取得目前執行個體的 Type。 (繼承自 Object)。
	NotifyBuildCompleted	通知伺服器具有所提供之 URI 的組建完成。
	QueryBuildDefinitions	查詢與輸入 [BuildItemSpec] 物件之項目的伺服器。如果 URI 是未知的，則這個方法可以用來將路徑尋找項目。
	QueryBuildDefinitionsByUri	指定的組建定義查詢一組 URI。伺服器會傳回每一個有效的 URI 的定義陣列。
	QueryBuilds	將陣列 [BuildDetailSpec] 物件，這個方法會傳回物件 [BuildQueryResult] 結果清單與相同型別的陣列。如果找不到相符項目，則 [BuildQueryResult] 物件會將空白清單。
	QueryBuildsByUri	依 URI 的查詢組建而不是具有所提供之選取的路徑。單一 [BuildQueryResult] 物件從查詢傳回，以 [BuildDetail] 清單與輸入 URI 陣列的長度。如果特定的 URI 不符合任何建置，則產生的 [BuildDetail] 清單中對應的索引會是空的。從查詢傳回的資料量藉由選取參數進行控制。
	QueryProcessTemplates
	StopBuilds	停止具有提供之 URI 的正在進行中的組建。如果組建已完成，則會忽略並考慮成功。執行呼叫的使用者必須擁有權限。AdministerBuild 停止所建立的所有 Team 專案。
	ToString	傳回 String，其中可能含有 Component 的名稱。這個方法不應該被覆寫。 (繼承自 MarshalByValueComponent)。
	UpdateBuildDefinitions	假設為陣列 [BuildDefinition] 物件，這個方法會更新為指定資料的伺服器組建定義。
	UpdateBuildInformation	根據提供的變更更新組建資訊。變更所涉及的所有資訊傳回至呼叫端除了刪除的節點。
	UpdateBuilds	更新使用所提供的資訊的組建詳細資料。使用者必須在包含組建來執行動作的 Team 專案 AdministerBuild 的使用權限。
	UpdateProcessTemplates

回頁首

事件

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

回頁首

執行緒安全

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

請參閱

參考

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