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 服务器用来处理 Web 请求的所有 HTTP 特定的上下文。 （继承自 WebService。）
	DesignMode	获取指示组件当前是否处于设计模式的值。 （继承自 MarshalByValueComponent。）
	Server	获取当前请求的 HttpServerUtility。 （继承自 WebService。）
	Session	获取当前请求的 HttpSessionState 实例。 （继承自 WebService。）
	Site	获取或设置组件的位置。 （继承自 MarshalByValueComponent。）
	SoapVersion	获取用于向 XML Web services 发送 SOAP 请求的 SOAP 协议的版本。 （继承自 WebService。）
	User	获取 ASP.NET 服务器 User 对象。可用于验证用户是否有权执行请求。 （继承自 WebService。）

页首

方法

	名称	说明
	AddBuildAgents
	AddBuildDefinitions	向服务器的 [BuildDefinition] 对象。如果URI字段在发送输入到服务器之前，它将被忽略。重复生成定义不能在同一路径存在。因此，如果遇到这种情况，则可能引发异常。添加在所有定义，以便，以便将失败，整个之间是事务性的添加失败。
	AddBuildQualities	添加质量列表到目标团队项目。执行添加的用户必须具有“EditBuildStatus的权限才能执行操作。
	CancelBuilds	在会推迟的或事件当前状态的取消生成过程在队列。执行取消操作的用户必须对团队项目的管理生成权限才能成功完成。
	DeleteBuildAgents
	DeleteBuildDefinitions	删除具有URI等效于它们传递数组作为参数从服务器的生成定义。仍会有与其定义，它们是否已完成或已排队并在“Active，“Postponed或“InProgress的状态，则不能删除。必须在移除该定义之前删除相关的生成。
	DeleteBuildQualities	从目标团队项目中删除指定的生成质量。执行此操作的用户必须对团队项目的“EditBuildStatus的权限。
	DeleteBuilds	删除对应于特定URI的生成。如果特定生成不存在，则会悄悄地忽略。如果此方法不引发任何异常，可以假定，删除操作的生成部件转到好。非致命错误(如"测试结果"删除失败(除了权限问题之外)，并放置位置访问问题的记录到事件日志和不考虑的错误。
	Dispose	释放由 MarshalByValueComponent 使用的所有资源。 （继承自 MarshalByValueComponent。）
	Equals	确定指定的对象是否等于当前对象。 （继承自 Object。）
	EvaluateSchedules	此方法要么当前不执行。其目的是使BuildService webservice运行。 它调用定期每10分钟。TFSServerScheduler服务。
	GetAffectedBuildDefinitions	确定，如果有，则会生成定义由提供的服务器项目的影响。
	GetBuildQualities	检索为目标团队项目存在的生成质量。用户必须对目标团队项目的“GenericRead权限才能查看生成质量。
	GetHashCode	用作特定类型的哈希函数。 （继承自 Object。）
	GetService	获取 IServiceProvider 的实施者。 （继承自 MarshalByValueComponent。）
	GetType	获取当前实例的 Type。 （继承自 Object。）
	ProcessChangeset
	QueryBuildAgentsByUri	查询使用URI列表的生成代理。列表中的输出将为作为输入列表具有NULL索引在每个位置未找到URI的大小。
	QueryBuildDefinitionsByUri	给定的生成定义的查询设置URI。服务器将返回每个有效的URI的定义在数组。
	QueryBuildGroups	查询匹配输入 [BuildItemSpec] 对象的项目的服务器。如果URI是未知的，此方法可用于将路径查看项目。
	QueryBuildQueue	查询生成队列特定设置代理和定义的规范。
	QueryBuildQueueById	按ID.查询排队的生成列表中的输出将为作为输入列表包含NULL索引与不存在的项对应的大小。
	QueryBuilds	将数组 [BuildDetailSpec] 对象，此web方法将返回结果列表 [BuildQueryResult] 对象相同大小与输入数组。如果未找到任何匹配，[BuildQueryResult] 对象将包含空列表。
	QueryBuildsByUri	由URI的查询生成而不是由具有提供的选项的路径。一个 [BuildQueryResult] 对象从查询返回，与BuildDetail列表长度和输入URI数组相同。如果特定URI不与任何生成，在发生的BuildDetail相应的索引列表将为空。从查询返回的数据量可选参数进行控制。
	QueueBuild	使用提供的请求，尝试对生成进行排队。如果插入成功，已排队生成的列表返回。已排队生成的QueueId能用于执行在项目的最新查询轮询。如果生成仅一个在排队和状态时的队列设置为“活动”。生成将立即开始。
	StopBuilds	停止点与提供的URI的正在进行的生成。如果生成已完成，则将忽略并考虑成功。执行此操作的订阅者调用必须具有AdministerBuild权限来停止创建的所有团队项目。
	ToString	返回包含 Component 的名称的 String（如果有）。不应重写此方法。 （继承自 MarshalByValueComponent。）
	UpdateBuildAgents
	UpdateBuildDefinitions
	UpdateBuildInformation
	UpdateBuilds	更新使用提供的信息的生成详细信息。用户必须在包含生成为了执行此操作的团队项目的AdministerBuild权限。
	UpdateQueuedBuilds	更新使用提供的信息的排队的生成。用户必须在包含已排队的生成为了执行此操作的团队项目的AdministerBuild权限。此方法是全部或nothing，这意味着所有更新中的工作效率低下或其工作。更改生成的会推迟的标志都可使开始。因此，因此，如果生成开始，[QueuedBuild] 对象的 [Build] 属性将被设置为。

页首

事件

	名称	说明
	Disposed	添加事件处理程序以侦听组件上的 Disposed 事件。 （继承自 MarshalByValueComponent。）

页首

线程安全

此类型的任何公共 static（在 Visual Basic 中为 Shared） 成员都是线程安全的。但不保证所有实例成员都是线程安全的。

请参见

参考

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