Condividi tramite


Classe BuildService

Gerarchia di ereditarietà

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

Spazio dei nomi:  Microsoft.TeamFoundation.Build.Server.Compatibility
Assembly:  Microsoft.TeamFoundation.Build.Server (in Microsoft.TeamFoundation.Build.Server.dll)

Sintassi

'Dichiarazione
<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

Il tipo BuildService espone i seguenti membri.

Costruttori

  Nome Descrizione
Metodo pubblico BuildService

In alto

Proprietà

  Nome Descrizione
Proprietà pubblica Application Ottiene l'oggetto applicazione per la richiesta HTTP corrente. (Ereditato da WebService)
Proprietà pubblica Container Ottiene il contenitore del componente. (Ereditato da MarshalByValueComponent)
Proprietà pubblica Context Ottiene il HttpContext ASP.NET per la richiesta corrente, che incapsula tutto il contesto HTTP specifico utilizzato dal server HTTP per elaborare le richieste Web. (Ereditato da WebService)
Proprietà pubblica DesignMode Ottiene un valore che indica se il componente è in modalità progettazione. (Ereditato da MarshalByValueComponent)
Proprietà pubblica Server Ottiene l'oggetto HttpServerUtility per la richiesta corrente. (Ereditato da WebService)
Proprietà pubblica Session Ottiene l'istanza HttpSessionState per la richiesta corrente. (Ereditato da WebService)
Proprietà pubblica Site Ottiene o imposta il sito del componente. (Ereditato da MarshalByValueComponent)
Proprietà pubblica SoapVersion Ottiene la versione del protocollo SOAP utilizzata per effettuare la richiesta SOAP al servizio Web XML. (Ereditato da WebService)
Proprietà pubblica User Ottiene l'oggetto User del server ASP.NET.Può essere utilizzato per verificare se un utente è autorizzato a eseguire la richiesta. (Ereditato da WebService)

In alto

Metodi

  Nome Descrizione
Metodo pubblico AddBuildAgents
Metodo pubblico AddBuildDefinitions Aggiunta di oggetti BuildDefinition al server.Se il campo dell'URI sarà inserito prima di essere inviato al server, verrà ignorata.Le definizioni di compilazione duplicate non possono esistere nello stesso percorso.Pertanto è possibile che venga generata un'eccezione se questo caso viene rilevato.L'aggiunta è transazionale per tutte le definizioni in modo che se si aggiunge l'esito negativo, tutto aggiungere il test ha esito negativo.
Metodo pubblico AddBuildQualities Aggiunto l'elenco di qualità del progetto team di destinazione.L'utente che esegue l'aggiunta è necessaria l'autorizzazione di "EditBuildStatus" per eseguire l'operazione.
Metodo pubblico CancelBuilds Compilazioni degli annullamenti presenti nella coda con stato o posposto attivo.L'utente che esegue l'annullamento è necessaria l'autorizzazione di compilazione di amministrazione sul progetto team per completare correttamente.
Metodo pubblico DeleteBuildAgents
Metodo pubblico DeleteBuildDefinitions Elimina le definizioni di compilazione dal server con URI equivalenti a quelli che vengono passati come parametro matrice.Le definizioni che presentano ancora compilazioni sono associate, se vengono completate o in coda e "design", "posposto", o nello stato "di InProgress", non possono essere eliminati.Le compilazioni dipendenti deve essere eliminato prima di rimuovere la definizione.
Metodo pubblico DeleteBuildQualities Elimina le qualità di compilazione specificato dal progetto team di destinazione.L'utente che esegue questa operazione è necessaria l'autorizzazione di "EditBuildStatus" nel progetto team.
Metodo pubblico DeleteBuilds Elimina compilazioni che corrispondono agli URI specificato.Se una compilazione specificata non esiste, viene ignorata automaticamente.Se il metodo non genera alcuna eccezione, può essere presuppostoe che la parte della compilazione di eliminazione è stato okay.Gli errori non fine degli errori di eliminazione dei risultati del test (ad eccezione dei problemi di autorizzazione) e problemi di accesso della destinazione finale vengono registrati solo nel log eventi e agli errori non considerati.
Metodo pubblico Dispose Rilascia tutte le risorse utilizzate dall'oggetto MarshalByValueComponent. (Ereditato da MarshalByValueComponent)
Metodo pubblico Equals Determina se l'oggetto specificato equivale all'oggetto corrente. (Ereditato da Object)
Metodo pubblico EvaluateSchedules Questo metodo non effettua alcuna operazione attualmente.Lo scopo di mantenere il webservice di BuildService attivo. Viene chiamato periodico- ogni 10 minuto- dal servizio di TFSServerScheduler.
Metodo pubblico GetAffectedBuildDefinitions Determina quale, se presente, definizioni di compilazione sono interessati dagli elementi forniti server.
Metodo pubblico GetBuildQualities Recupera le qualità di compilazione esistenti per il progetto team di destinazione.L'utente deve disporre dell'autorizzazione "di GenericRead" nel progetto team di destinazione per visualizzare le qualità di compilazione.
Metodo pubblico GetHashCode Funge da funzione hash predefinita. (Ereditato da Object)
Metodo pubblico GetService Ottiene l'implementatore dell'interfaccia IServiceProvider. (Ereditato da MarshalByValueComponent)
Metodo pubblico GetType Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
Metodo pubblico ProcessChangeset
Metodo pubblico QueryBuildAgentsByUri Eseguire una query sugli agenti di compilazione con un elenco degli URI.L'elenco di output sarà la stessa dimensione dell'elenco di input contenente un valore NULL in ogni posizione in cui un URI non è stato trovato.
Metodo pubblico QueryBuildDefinitionsByUri Query per le definizioni di compilazione fornisce un set di URI.Il server restituirà una definizione per ogni URI valido nella matrice.
Metodo pubblico QueryBuildGroups Eseguire una query sul server per gli elementi che corrispondono agli oggetti di input di BuildItemSpec.Questo metodo può essere utilizzato per individuare gli elementi di utilizzare il percorso se l'URI sarà sconosciuto.
Metodo pubblico QueryBuildQueue Eseguire una query sulla coda di compilazione in base a un insieme di specifiche per gli agenti e le definizioni.
Metodo pubblico QueryBuildQueueById Eseguire una query sulle compilazioni in coda tramite ID.L'elenco di output sarà la stessa dimensione dell'elenco di input contenente valori NULL che corrispondono alle voci non esistenti.
Metodo pubblico QueryBuilds Specificando una matrice di oggetti BuildDetailSpec, questo metodo Web restituisce un elenco di risultati di oggetti BuildQueryResult la stessa dimensione della matrice di input.Se non sono state trovate corrispondenze, l'oggetto BuildQueryResult avrà semplicemente elenchi vuoti.
Metodo pubblico QueryBuildsByUri Compilazioni di query l'uri anziché dal percorso con le opzioni specificate.Un singolo oggetto BuildQueryResult viene restituito dalla query, con un elenco di BuildDetail la stessa lunghezza della matrice URI dell'input.Se un URI specifico non corrisponde alle compilazioni, l'indice corrispondente nell'elenco risultante di BuildDetail sarà null.La quantità di dati restituiti dalla query viene controllata tramite il parametro di opzioni.
Metodo pubblico QueueBuild Tentativi di accodamento le compilazioni tramite le richieste fornite.Se accodare ha esito positivo, un elenco delle compilazioni in coda viene restituito.Il QueueId della compilazione in coda può essere utilizzato per eseguire query successivi sull'elemento per eseguire il polling di.Se la compilazione è l'unico record in coda ai tempi accodare e dello stato è "attivo impostato." la compilazione eseguita immediatamente.
Metodo pubblico StopBuilds Interrompe le compilazioni in corso con URI forniti.Se una compilazione è già stata completata, verrà ignorata e considerato un esito positivo.L'utente che esegue questa chiamata è necessaria l'autorizzazione di AdministerBuild a tutte le interruzioni di progetti team per il quale si sta utilizzando.
Metodo pubblico ToString Restituisce un oggetto String contenente il nome dell'oggetto Component, se presente.Non è consigliabile eseguire l'override di questo metodo. (Ereditato da MarshalByValueComponent)
Metodo pubblico UpdateBuildAgents
Metodo pubblico UpdateBuildDefinitions
Metodo pubblico UpdateBuildInformation
Metodo pubblico UpdateBuilds Dettagli compilazione degli aggiornamenti con le informazioni fornite.L'utente deve disporre di autorizzazioni di AdministerBuild sul progetto team che contiene la compilazione per eseguire questa operazione.
Metodo pubblico UpdateQueuedBuilds Compilazioni accodate aggiornamenti con le informazioni fornite.L'utente deve disporre di autorizzazioni di AdministerBuild sul progetto team che contiene la compilazione in coda per eseguire questa operazione.Questo metodo è radicale, pertanto eventuali aggiornamenti esecuzione o non ne lavoro.Modificare il flag posposto di una compilazione può seguito verrà avviato.Di conseguenza, la proprietà di compilazione dell'oggetto QueuedBuild verrà impostata se la compilazione viene avviata.

In alto

Eventi

  Nome Descrizione
Evento pubblico Disposed Aggiunge un gestore eventi per restare in attesa dell'evento Disposed sul componente. (Ereditato da MarshalByValueComponent)

In alto

Codice thread safe

Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.

Vedere anche

Riferimenti

Spazio dei nomi Microsoft.TeamFoundation.Build.Server.Compatibility