Compartilhar via


Classe BuildService

Hierarquia de herança

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 (em Microsoft.TeamFoundation.Build.Server.dll)

Sintaxe

'Declaração
<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

O tipo BuildService expõe os membros a seguir.

Construtores

  Nome Descrição
Método público BuildService

Superior

Propriedades

  Nome Descrição
Propriedade pública Application Obtém o objeto application para a solicitação HTTP atual. (Herdado de WebService.)
Propriedade pública Container Obtém o recipiente para o componente. (Herdado de MarshalByValueComponent.)
Propriedade pública Context Obtém a versão do ASP.NET HttpContext para a solicitação atual, que encapsula todos os contexto de HTTP específicos usados pelo servidor HTTP para processar solicitações da Web. (Herdado de WebService.)
Propriedade pública DesignMode Obtém um valor que indica se o componente está atualmente no modo de design. (Herdado de MarshalByValueComponent.)
Propriedade pública Server Obtém o HttpServerUtility para a solicitação atual. (Herdado de WebService.)
Propriedade pública Session Obtém o HttpSessionState instância para a solicitação atual. (Herdado de WebService.)
Propriedade pública Site Obtém ou define o site do componente. (Herdado de MarshalByValueComponent.)
Propriedade pública SoapVersion Obtém a versão do protocolo SOAP usado para fazer a solicitação SOAP em XML Web Services. (Herdado de WebService.)
Propriedade pública User Obtém a versão do ASP.NET server User objeto.Pode ser usado para autenticar se um usuário está autorizado a executar a solicitação. (Herdado de WebService.)

Superior

Métodos

  Nome Descrição
Método público AddBuildAgents
Método público AddBuildDefinitions Adiciona os objetos de BuildDefinition para o servidor.Se o campo URI é conectado antes de ser enviado para o servidor, será ignorado.As definições de compilação duplicados não podem existir no mesmo caminho.Portanto pode ser apresentada uma exceção se esses casos são encontrados.Adicionar é transacional por todas as definições de modo que se adicionar falha, todas as adiciona a falha.
Método público AddBuildQualities Adiciona a lista de qualidades ao projeto de equipe de destino.O usuário que executa adicionar deve ter a permissão de “EditBuildStatus” para executar a ação.
Método público CancelBuilds Os cancelamentos compilação na fila que estão em estado ativo ou adiado.O usuário que executa o botão deve ter a permissão de compilação de administração do projeto de equipe para concluir com êxito.
Método público DeleteBuildAgents
Método público DeleteBuildDefinitions Exclusões criar definições de servidor que têm o equivalente de URIs aquelas que são passados como o parâmetro de matriz.As definições que ainda têm compilações se têm com elas, se eles concluíram ou colocadas na fila e “ativo”, “adiado em”, ou de InProgress”, “não podem ser excluídas.As compilações dependentes devem ser excluídas antes de remover a definição.
Método público DeleteBuildQualities Exclui as especificadas qualidades de compilação do projeto de equipe de destino.O usuário que executa essa ação deve ter a permissão de “EditBuildStatus” no projeto de equipe.
Método público DeleteBuilds Excluir compilações que correspondem ao URIs determinado.Se uma determinada compilação não existir, ele será ignorada silenciosamente.Se este método não lança exceções, nenhuma pode assumir que a parte da compilação de exclusão foi é bem.Erros não fatais como falhas de exclusão do resultado de teste (diferente de problemas de permissão) e problemas de acesso do local de recebimento são registrados em log apenas para o log de eventos e a erros não vistos.
Método público Dispose Libera todos os recursos usados pela MarshalByValueComponent. (Herdado de MarshalByValueComponent.)
Método público Equals Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object.)
Método público EvaluateSchedules Este método não fará nada atualmente.O propósito é manter o webservice de BuildService ativa. É chamada periódico- cada 10 minuto- pelo serviço de TFSServerScheduler.
Método público GetAffectedBuildDefinitions Determina qual, se houver, definições de compilação são afetados pelos itens fornecidos do servidor.
Método público GetBuildQualities Recupera as qualidades de compilação que existem para o projeto de equipe de destino.O usuário deve ter a permissão de “GenericRead” no projeto de equipe de destino para exibir as qualidades de compilação.
Método público GetHashCode Serve como a função de hash padrão. (Herdado de Object.)
Método público GetService Obtém o implementador da IServiceProvider. (Herdado de MarshalByValueComponent.)
Método público GetType Obtém Type da instância atual. (Herdado de Object.)
Método público ProcessChangeset
Método público QueryBuildAgentsByUri Consultas agentes de compilação que usam uma lista de URIs.A lista de saída será o mesmo tamanho que a lista de entrada que possui um índice NULO em cada posição onde o URI não foi encontrado.
Método público QueryBuildDefinitionsByUri Consultas para as definições de compilação fornecidas um conjunto de URIs.O servidor retornará uma definição para cada o URI válido na matriz.
Método público QueryBuildGroups Consulta o servidor para os itens que correspondem aos objetos de BuildItemSpec de entrada.Esse método pode ser usado para descobrir itens por meio de caminho se o URI é conhecido.
Método público QueryBuildQueue Consulta a fila de compilação fornecida um conjunto de especificações para agentes e definições.
Método público QueryBuildQueueById Consulta as compilações enfileiradas por IDA lista de saída será o mesmo tamanho que a lista de entrada que tem os índices NULOS que correspondem às entradas inexistentes.
Método público QueryBuilds Dado uma matriz de objetos BuildDetailSpec , esse método da Web retorna uma lista de resultado de objetos BuildQueryResult o mesmo tamanho que a matriz de entrada.Se nenhuma correspondência for encontrada, o objeto de BuildQueryResult terá apenas listas vazios.
Método público QueryBuildsByUri Consultas são criados por um URI em vez pelo caminho com as opções fornecidas.Um único objeto de BuildQueryResult é retornado de consulta, com uma lista de BuildDetail o mesmo tamanho que o URI de entrada põe.Se o URI específico não coincide com nenhuma compilações, o índice correspondente na lista de BuildDetail resultante será nulo.A quantidade de dados retornados de consulta é controlada por meio do parâmetro options.
Método público QueueBuild Tentativas de enviar a fila compilações usando as solicitações fornecidas.Se o message queuing services for bem-sucedida, uma lista das compilações na fila é retornada.O QueueId de compilação na fila pode ser usado para executar uma consulta posteriores no item para procurar.Se a compilação for único na fila no momento do message queuing services e de status é “ativa definido.” a compilação iniciará imediatamente.
Método público StopBuilds Para compilações em andamento com o URIs fornecido.Se uma compilação foi concluída já, será ignorada e verão um êxito.O usuário que executa essa chamada deve ter a permissão de AdministerBuild a todos os projetos de equipe para que as paradas estão sendo feitas.
Método público ToString Retorna um String contendo o nome da Component, se houver.Este método não deve ser substituído. (Herdado de MarshalByValueComponent.)
Método público UpdateBuildAgents
Método público UpdateBuildDefinitions
Método público UpdateBuildInformation
Método público UpdateBuilds Detalhes de compilação as atualizações com as informações fornecidas.O usuário deve ter a permissão de AdministerBuild no projeto de equipe que contém a compilação para executar esta ação.
Método público UpdateQueuedBuilds Compilações colocadas em atualizações com as informações fornecidas.O usuário deve ter a permissão de AdministerBuild no projeto de equipe que contém a compilação na fila para executar esta ação.Este método é todo ou nada, o que significa que todas as atualizações funcionam ou nenhum deless trabalho.Altere o sinalizador adiado de uma compilação pode causar-la a ser iniciada.Portanto, a propriedade do objeto de QueuedBuild será definida se a compilação é iniciada.

Superior

Eventos

  Nome Descrição
Evento público Disposed Adiciona um manipulador de eventos para ouvir o Disposed evento no componente. (Herdado de MarshalByValueComponent.)

Superior

Acesso thread-safe

Quaisquer membros estático (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Consulte também

Referência

Namespace Microsoft.TeamFoundation.Build.Server.Compatibility