BuildService Class
Inheritance Hierarchy
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
Namespace: Microsoft.TeamFoundation.Build.Server.Compatibility
Assembly: Microsoft.TeamFoundation.Build.Server (in Microsoft.TeamFoundation.Build.Server.dll)
Syntax
'Declaration
<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
[ClientServiceAttribute(ComponentName = L"TeamBuild", RegistrationName = L"Build",
ServiceName = L"BuildService", CollectionServiceIdentifier = L"543cf133-319b-4c7b-800a-fafff734f291")]
[WebServiceAttribute(Namespace = L"https://schemas.microsoft.com/TeamFoundation/2005/06/Build/BuildService/03",
Description = L"Team Foundation Build web service")]
public ref class BuildService sealed : public BuildWebServiceBase
[<Sealed>]
[<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")>]
type BuildService =
class
inherit BuildWebServiceBase
end
public final class BuildService extends BuildWebServiceBase
The BuildService type exposes the following members.
Constructors
| Name | Description | |
|---|---|---|
.gif "Public method") |
BuildService |
Top
Properties
| Name | Description | |
|---|---|---|
.gif "Public property") |
Application | Gets the application object for the current HTTP request. (Inherited from WebService.) |
|
Container | Gets the container for the component. (Inherited from MarshalByValueComponent.) |
|
Context | Gets the ASP.NET HttpContext for the current request, which encapsulates all HTTP-specific context used by the HTTP server to process Web requests. (Inherited from WebService.) |
|
DesignMode | Gets a value indicating whether the component is currently in design mode. (Inherited from MarshalByValueComponent.) |
|
Server | Gets the HttpServerUtility for the current request. (Inherited from WebService.) |
|
Session | Gets the HttpSessionState instance for the current request. (Inherited from WebService.) |
|
Site | Gets or sets the site of the component. (Inherited from MarshalByValueComponent.) |
|
SoapVersion | Gets the version of the SOAP protocol used to make the SOAP request to the XML Web service. (Inherited from WebService.) |
|
User | Gets the ASP.NET server User object. Can be used to authenticate whether a user is authorized to execute the request. (Inherited from WebService.) |
Top
Methods
| Name | Description | |
|---|---|---|
|
AddBuildAgents | |
|
AddBuildDefinitions | Adds the BuildDefinition objects to the server. If the URI field is entered before being sent to the server, it will be ignored. Duplicate build definitions may not exist at the same path. Therefore an exception may be thrown if this case is encountered. The add is transactional across all definitions so that if one add fails, all of the adds fail. |
|
AddBuildQualities | Adds the list of qualities to the target team project. The user performing the add must have the 'EditBuildStatus' permission in order to perform the action. |
|
CancelBuilds | Cancels builds currently in the queue that are either in the Postponed or Active state. The user performing the cancel must have the administer build permission on the team project in order to complete successfully. |
|
DeleteBuildAgents | |
|
DeleteBuildDefinitions | Deletes build definitions from the server that have URIs equivalent to those that are passed in as the array parameter. Definitions that still have builds associated with them, whether they're completed or queued and in the 'Active', 'Postponed', or 'InProgress' state, cannot be deleted. The dependent builds must be deleted before removing the definition. |
|
DeleteBuildQualities | Deletes the specified build qualities from the target team project. The user performing this action must have the 'EditBuildStatus' permission on the team project. |
|
DeleteBuilds | Deletes the builds that correspond to the given URIs. If a given build does not exist, it is silently ignored. If this method does not throw any exceptions, it can be assumed that the Build part of the delete went okay. Non-fatal errors such as test result deletion failures (other than permission problems) and drop location access issues are just logged to the event log and not considered errors. |
|
Dispose | Releases all resources used by the MarshalByValueComponent. (Inherited from MarshalByValueComponent.) |
|
Equals | Determines whether the specified object is equal to the current object. (Inherited from Object.) |
|
EvaluateSchedules | This method does nothing currently.Its purpose is to keep the BuildService webservice alive. It is called periodically—every 10 minutes—by the TFSServerScheduler service. |
|
GetAffectedBuildDefinitions | Determines which, if any, build definitions are affected by the provided server items. |
|
GetBuildQualities | Retrieves the build qualities that exist for the target team project. The user must have the 'GenericRead' permission on the target team project in order to view the build qualities. |
|
GetHashCode | Serves as the default hash function. (Inherited from Object.) |
|
GetService | Gets the implementer of the IServiceProvider. (Inherited from MarshalByValueComponent.) |
|
GetType | Gets the Type of the current instance. (Inherited from Object.) |
|
ProcessChangeset | |
|
QueryBuildAgentsByUri | Queries build agents using a list of URIs. The output list will be the same size as the input list that has a NULL index in each position where a URI was not found. |
|
QueryBuildDefinitionsByUri | Queries for build definitions given a set of URIs. The server will return a definition for each valid URI in the array. |
|
QueryBuildGroups | Queries the server for items that match the input BuildItemSpec objects. This method may be used to discover items by means of the path if the URI is unknown. |
|
QueryBuildQueue | Queries the build queue given a set of specifications for agents and definitions. |
|
QueryBuildQueueById | Queries the queued builds by ID. The output list will be the same size as the input list that has NULL indexes corresponding to non-existent entries. |
|
QueryBuilds | Given an array of BuildDetailSpec objects, this web method will return a result list of BuildQueryResult objects the same size as the input array. If no matches were found, the BuildQueryResult object will just have empty lists. |
|
QueryBuildsByUri | Queries builds by URI instead of by path with the provided options. A single BuildQueryResult object is returned from the query, with a BuildDetail list the same length as the input URI array. If a particular URI does not match any builds, the corresponding index in the resulting BuildDetail list will be null. The amount of data returned from the query is controlled by means of the options parameter. |
|
QueueBuild | Attempts to enqueue builds using the provided requests. If the queueing is successful, a list of the queued builds is returned. The QueueId of the queued build may be used to perform later queries on the item for polling. If the build is the only one in the queue at the time of queueing and the Status is set to 'Active.' the build will start immediately. |
|
StopBuilds | Stops in-progress builds with the provided URIs. If a build has already been completed, it will be ignored and considered a success. The user performing this call must have the AdministerBuild permission to all team projects for which stops are being made. |
|
ToString | Returns a String containing the name of the Component, if any. This method should not be overridden. (Inherited from MarshalByValueComponent.) |
|
UpdateBuildAgents | |
|
UpdateBuildDefinitions | |
|
UpdateBuildInformation | |
|
UpdateBuilds | Updates build details with the provided information. The user must have the AdministerBuild permission on the team project that contains the build in order to perform this action. |
|
UpdateQueuedBuilds | Updates queued builds with the provided information. The user must have the AdministerBuild permission on the team project that contains the queued build in order to perform this action.This method is all or nothing, meaning that either all of the updates work or none of them work. Changing the postponed flag of a build may cause it to be started. Therefore, the Build property of the QueuedBuild object will be set if the build is started. |
Top
Events
| Name | Description | |
|---|---|---|
.gif "Public event") |
Disposed | Adds an event handler to listen to the Disposed event on the component. (Inherited from MarshalByValueComponent.) |
Top
Thread Safety
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
See Also
Reference
Microsoft.TeamFoundation.Build.Server.Compatibility Namespace