How to determine if a build is queued but not started in the TFS2010 API?

Im using the enum Microsoft.TeamFoundation.Build.Client.BuildStatus for each and it works great for the statuses contained in it.

But is there a blat开发者_如何学Pythonantly obvious way of determining if a build is queued, but not yet in progress? I know the build explorer in visual studio can see this, im having problems getting that data programmatically.

Do i have to check something on the teamproject instead of the IBuildDetail itself? Any tips appreciated.

---

Unfortunately it doesn't appear that IBuildDetailSpec queries ever return queued builds. However, you can use the IQueuedBuildSpec interface to query for queued builds.

For example:

public IEnumerable<IQueuedBuild> getQueuedBuilds(TfsTeamProjectCollection tfsCollection, string teamProject)
{
    // Get instance of build server service from TFS
    IBuildServer buildServer = tfsCollection.GetService<IBuildServer>();

    // Set up query
    IQueuedBuildSpec spec = buildServer.CreateBuildQueueSpec(teamProject);
    spec.Status = QueueStatus.Queued;

    // Execute query
    IQueuedBuildQueryResult result = buildServer.QueryQueuedBuilds(spec);

    // Array of queued builds will be in the result.QueuedBuilds property
    return result.QueuedBuilds;
}

---

You should be able to see the build status as BuildStatus.NotStarted once the build actually reaches the queue. There is a time before it reaches the queue that it really doesn't have a status, though.

If you're submitting your build programmatically, you can do:

bool success = queue.WaitForBuildStart(pollingIntervalInMilliseconds, timeOutInMilliseconds);

As long as the agent is listening, this should actually return very quickly. If you have a slow network, this could potentially take a couple seconds for handshaking.

Once it passes the WaitForBuildStart, the status is set to BuildStatus.NotStarted until it moves to InProgress and the rest of the way down the line.

---

@Greg Case First thank you for the code , you gave me the solution that I was searching for. Second , I want to suggest using the same code snippet of yours to receive notifications from TFS for specific Queued build. I already used it to get notified that the build I queued is completed and it even returns exception details for failure case . To do that you need to connect() to the queued build returned from code and then register event , I wanted to add it as a comment but couldn't for long text

IQueuedBuild CurrentBuild =  result.QueuedBuilds.First();
CurrentBuild.Connect(); 
CurrentBuild.PollingCompleted += CurrentBuild_PollingCompleted;