Partager via

BuildService, classe

  • Article

Hiérarchie d'héritage

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

Espace de noms :  Microsoft.TeamFoundation.Build.Server.Compatibility
Assembly :  Microsoft.TeamFoundation.Build.Server (dans Microsoft.TeamFoundation.Build.Server.dll)

Syntaxe

'Déclaration
<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

Le type BuildService expose les membres suivants.

Constructeurs

  Nom Description
Méthode publique BuildService

Début

Propriétés

  Nom Description
Propriété publique Application Obtient l'objet Application de la requête HTTP en cours. (Hérité de WebService.)
Propriété publique Container Obtient le conteneur du composant. (Hérité de MarshalByValueComponent.)
Propriété publique Context Obtient HttpContext ASP.NET pour la demande en cours, qui encapsule tout le contexte spécifique à HTTP utilisé par le serveur HTTP pour traiter les demandes Web. (Hérité de WebService.)
Propriété publique DesignMode Obtient une valeur indiquant si le composant est actuellement en mode design. (Hérité de MarshalByValueComponent.)
Propriété publique Server Obtient le HttpServerUtility pour la demande en cours. (Hérité de WebService.)
Propriété publique Session Obtient l'instance HttpSessionState pour la demande en cours. (Hérité de WebService.)
Propriété publique Site Obtient ou définit le site du composant. (Hérité de MarshalByValueComponent.)
Propriété publique SoapVersion Obtient la version du protocole SOAP utilisée pour faire la demande SOAP au service Web XML. (Hérité de WebService.)
Propriété publique User Obtient l'objet User du serveur ASP.NET.Peut être utilisé pour déterminer par l'authentification si un utilisateur est autorisé à exécuter la demande. (Hérité de WebService.)

Début

Méthodes

  Nom Description
Méthode publique AddBuildAgents
Méthode publique AddBuildDefinitions Ajoute les objets BuildDefinition au serveur.Si le champ d'URI est entré avant d'être envoyés au serveur, il sera ignoré.Les définitions de build en double ne pas exister au même chemin d'accès.Par conséquent une exception peut être levée si ce cas est produit.L'ajout est transactionnel entre toutes les définitions afin que s'il ajoutent de échec, tous les ajoute l'échec.
Méthode publique AddBuildQualities Ajoute la liste des qualités au projet d'équipe cible.L'utilisateur exécutant l'ajout doit avoir l'autorisation « EditBuildStatus » pour exécuter l'action.
Méthode publique CancelBuilds Les annule génère actuellement dans la file d'attente qui ont l'état fourni ou actif ultérieurement.L'utilisateur qui exécute l'annulation doit avoir l'autorisation de génération d'administrateur sur le projet d'équipe afin de s'exécuter correctement.
Méthode publique DeleteBuildAgents
Méthode publique DeleteBuildDefinitions Supprime les définitions de build du serveur qui ont des URI équivaut à ceux qui sont passés comme paramètre de tableau.Les définitions qui ont encore des builds associés à elles, si elles sont terminées ou mises et à en file d'attente « actif », « ajourné », ou l'état « InProgress », ne peuvent pas être supprimées.Les builds dépendantes doivent être supprimées avant de supprimer la définition.
Méthode publique DeleteBuildQualities Supprime les qualités de build spécifiées du projet d'équipe cible.L'utilisateur effectuant cette action doit avoir l'autorisation « EditBuildStatus » sur le projet d'équipe.
Méthode publique DeleteBuilds Supprime les builds qui correspondent aux URI donnés.Si une build spécifiée n'existe pas, elle est automatiquement ignorée.Si cette méthode ne lève pas d'exception, il peut prendre que la partie de génération de la suppression est échecs rencontrés correct.Les erreurs récupérables telles que les échecs de suppression de résultat des tests (autre que des problèmes d'autorisation) et problèmes d'accès cible sont simplement enregistrées dans le journal des événements et des erreurs non prises en compte.
Méthode publique Dispose Libère toutes les ressources utilisées par MarshalByValueComponent. (Hérité de MarshalByValueComponent.)
Méthode publique Equals Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode publique EvaluateSchedules Cette méthode ne fait rien actuellement.Son objectif est de conserver le webservice de BuildService actif. Il est appelé périodique-chaque 10 minute-par le service de TFSServerScheduler.
Méthode publique GetAffectedBuildDefinitions Détermine que, le cas échéant, définitions de build sont affectées par les éléments serveur fournis.
Méthode publique GetBuildQualities Récupère les qualités de build qui existent pour le projet d'équipe cible.L'utilisateur doit avoir l'autorisation « GenericRead » sur le projet d'équipe cible pour afficher les qualités de build.
Méthode publique GetHashCode Sert de fonction de hachage par défaut. (Hérité de Object.)
Méthode publique GetService Obtient l'implémenteur du IServiceProvider. (Hérité de MarshalByValueComponent.)
Méthode publique GetType Obtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publique ProcessChangeset
Méthode publique QueryBuildAgentsByUri Interroge des agents de build à l'aide d'une liste d'URI.La liste de sortie est la même taille qu'liste d'entrée qui a un index Null dans chaque emplacement où l'URI est introuvable.
Méthode publique QueryBuildDefinitionsByUri Recherche des définitions de build données un ensemble d'URI.Le serveur retourne une définition pour chaque URI valide dans le tableau.
Méthode publique QueryBuildGroups Interroge le serveur pour les éléments qui correspondent aux objets d'entrée de BuildItemSpec.Cette méthode peut être utilisée pour découvrir des éléments au moyen du tracé si l'URI est inconnu.
Méthode publique QueryBuildQueue Interroge la file d'attente de build donnée un jeu de fonctionnalités pour des agents et des définitions.
Méthode publique QueryBuildQueueById Interroge les builds en file d'attente par ID.La liste de sortie est la même taille qu'liste d'entrée avec les index Null correspondant aux entrées inexistantes.
Méthode publique QueryBuilds Soit un tableau d'objets BuildDetailSpec, cette méthode Web retourne une liste de résultats d'objets BuildQueryResult la même taille qu'un tableau d'entrée.Si aucune correspondance n'est trouvée, l'objet BuildQueryResult aura uniquement les listes vides.
Méthode publique QueryBuildsByUri Les requêtes génère par un URI plutôt que par le tracé avec les options fournies.Objet BuildQueryResult unique est retourné par la requête, avec une liste de BuildDetail la même longueur que l'URI d'entrée range.Si l'URI particulier ne correspond à aucune génération, l'index correspondant dans la liste résultante de BuildDetail sera null.La quantité de données retournées par la requête est contrôlée par l'intermédiaire du paramètre d'options.
Méthode publique QueueBuild Essaie de mettre des builds en file d'attente à l'aide des demandes fournies.Si la mise en file d'attente est réussi, une liste des builds en file d'attente est retournée.Le QueueId de la génération en file d'attente peut être utilisé pour exécuter des requêtes ultérieures sur l'élément pour l'interrogation.Si la génération est le seul dans la file d'attente au moment de la mise en file d'attente et l'état est « actif défini ». la génération commence immédiatement.
Méthode publique StopBuilds Arrête des builds en cours avec les URI fournis.Si une génération a déjà été effectuée, elle sera ignorée et considérait un succès.L'utilisateur exécutant cet appel doit avoir l'autorisation d'AdministerBuild à tous les projets d'équipe pour lequel les abandons effectuée.
Méthode publique ToString Retourne String contenant le nom du Component, s'il existe.Cette méthode ne doit pas être substituée. (Hérité de MarshalByValueComponent.)
Méthode publique UpdateBuildAgents
Méthode publique UpdateBuildDefinitions
Méthode publique UpdateBuildInformation
Méthode publique UpdateBuilds Détails de la build de mises à jour avec les informations fournies.L'utilisateur doit avoir l'autorisation d'AdministerBuild sur le projet d'équipe qui contient la génération pour exécuter cette action.
Méthode publique UpdateQueuedBuilds Builds mises en file d'attente par mises à jour avec les informations fournies.L'utilisateur doit avoir l'autorisation d'AdministerBuild sur le projet d'équipe qui contient la build en file d'attente pour exécuter cette action.Cette méthode est tout ou rien, ce qui signifie que toutes les mises à jour exécutez ou aucun de ces travail.Modification de l'indicateur ajourné d'une build peut la ne puissent démarrer.Par conséquent, la propriété de génération de l'objet QueuedBuild est définie si la génération est démarrée.

Début

Événements

  Nom Description
Événement public Disposed Ajoute un gestionnaire d'événements qui doit écouter l'événement Disposed pour le composant. (Hérité de MarshalByValueComponent.)

Début

Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Voir aussi

Référence

Microsoft.TeamFoundation.Build.Server.Compatibility, espace de noms