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 服务器用来处理 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 等效于它们传递数组作为参数从服务器的生成定义。仍会有与其定义，它们是否已完成或已排队并在“活动”，“推迟”或“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. 查询排队的生成列表中的输出将为作为输入列表包含空索引与不存在的项对应的大小。
	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 对象的编译属性将被设置为。

页首

事件

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

页首

线程安全

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

请参阅

参考

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