Compartir a través de

BuildService (Clase)

  • Artículo

Jerarquía de herencia

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

Espacio de nombres:  Microsoft.TeamFoundation.Build.Server.Compatibility
Ensamblado:  Microsoft.TeamFoundation.Build.Server (en Microsoft.TeamFoundation.Build.Server.dll)

Sintaxis

'Declaración
<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

El tipo BuildService expone los siguientes miembros.

Constructores

  Nombre Descripción
Método público BuildService

Arriba

Propiedades

  Nombre Descripción
Propiedad pública Application Obtiene el objeto de aplicación de la solicitud HTTP actual. (Se hereda de WebService).
Propiedad pública Container Obtiene el contenedor del componente. (Se hereda de MarshalByValueComponent).
Propiedad pública Context Obtiene el objeto HttpContext de ASP.NET para la solicitud actual, que encapsula todo el contexto específico de HTTP utilizado por el servidor HTTP para procesar solicitudes Web. (Se hereda de WebService).
Propiedad pública DesignMode Obtiene un valor que indica si el componente está actualmente en modo de diseño. (Se hereda de MarshalByValueComponent).
Propiedad pública Server Obtiene el valor de la clase HttpServerUtility para la solicitud actual. (Se hereda de WebService).
Propiedad pública Session Obtiene la instancia de HttpSessionState para la solicitud actual. (Se hereda de WebService).
Propiedad pública Site Obtiene o establece el sitio del componente. (Se hereda de MarshalByValueComponent).
Propiedad pública SoapVersion Obtiene la versión del protocolo SOAP utilizada para realizar la solicitud SOAP al servicio Web XML. (Se hereda de WebService).
Propiedad pública User Obtiene el objeto de servidor ASP.NET User.Puede utilizarse con el fin de autenticar la autorización de un usuario para ejecutar la solicitud. (Se hereda de WebService).

Arriba

Métodos

  Nombre Descripción
Método público AddBuildAgents
Método público AddBuildDefinitions Agrega los objetos de BuildDefinition al servidor.Si el campo de URI se entra antes de ser enviados al servidor, se omitirá.Las definiciones de compilación de duplicado pueden no exista en la misma ruta de acceso.Por consiguiente se puede producir una excepción si se encuentra este caso.Al agregar es transaccional en todas las definiciones de modo que si se agrega un error, todo el agregue errores.
Método público AddBuildQualities Agrega la lista de calidades al proyecto de equipo de destino.El usuario que realiza el agregar debe disponer del permiso “EditBuildStatus” para realizar la acción.
Método público CancelBuilds Las cancelaciones compilan actualmente en la cola que están en el Postponed o el estado activo.El usuario que realiza la cancelación debe tener el permiso de compilación de administración en el proyecto de equipo para completar correctamente.
Método público DeleteBuildAgents
Método público DeleteBuildDefinitions Elimina las definiciones de compilación del servidor que tienen identificadores URI equivalentes a los que se pasen como parámetro de matriz.Las definiciones que tienen compilaciones asociadas a ellos, si se completen o en cola y en “activo”, “Postponed”, o el estado de “InProgress”, no se han eliminado.Las compilaciones dependientes se deben eliminar antes de quitar la definición.
Método público DeleteBuildQualities Elimina las calidades especificadas de compilación del proyecto de equipo de destino.El usuario que realiza esta acción debe disponer del permiso “EditBuildStatus” en el proyecto de equipo.
Método público DeleteBuilds Elimina las compilaciones que corresponden a los URI especificados.Si no existe una compilación determinada, se omite automáticamente.Si este método no produce ninguna excepción, se supone que se la parte de la generación de cancelación OK.Los errores no graves como errores de la eliminación del resultado de la prueba (distinto de problemas de permisos) y problemas de acceso de la ubicación de destino simplemente se registran en el registro de eventos y los errores no en.
Método público Dispose Libera todos los recursos utilizados por MarshalByValueComponent. (Se hereda de MarshalByValueComponent).
Método público Equals Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
Método público EvaluateSchedules Este método no hace nada actualmente.El propósito es mantener el webservice de BuildService activo. Se llama periódico- cada 10 minuto- por el servicio de TFSServerScheduler.
Método público GetAffectedBuildDefinitions Determina que, si existe, crear definiciones se ven afectadas por los elementos proporcionados de servidor.
Método público GetBuildQualities Recupera las calidades de compilación que existen para el proyecto de equipo de destino.El usuario debe disponer del permiso “GenericRead” en el proyecto de equipo de destino para ver las calidades de compilación.
Método público GetHashCode Sirve como la función hash predeterminada. (Se hereda de Object).
Método público GetService Obtiene el implementador de IServiceProvider. (Se hereda de MarshalByValueComponent).
Método público GetType Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
Método público ProcessChangeset
Método público QueryBuildAgentsByUri Las consultas agentes mediante una lista de URI.La lista de resultados será el mismo tamaño que la entrada muestra que tiene un índice de NULL en cada posición donde un URI no encontrada.
Método público QueryBuildDefinitionsByUri Consultas para las definiciones de compilación con un conjunto de URI.El servidor devolverá una definición para cada URI válido en la matriz.
Método público QueryBuildGroups Consultas el servidor para los elementos que coinciden con los objetos de BuildItemSpec de entrada.Este método se puede utilizar para detectar elementos mediante la ruta de acceso si el URI es desconocido.
Método público QueryBuildQueue Consulta la cola de compilación dado un conjunto de especificaciones para los agentes y las definiciones.
Método público QueryBuildQueueById Consultas las compilaciones en cola por identificadorLa lista de resultados será el mismo tamaño que la entrada muestra que tiene índices NULL correspondiente a entradas inexistentes.
Método público QueryBuilds Especifica una matriz de los objetos de BuildDetailSpec , este método web devolverá una lista de objetos de BuildQueryResult el mismo tamaño que la matriz de entrada.Si no se encuentra ninguna coincidencia, el objeto de BuildQueryResult sólo tendrá listas vacías.
Método público QueryBuildsByUri Las consultas se compilan por el URI en lugar de la ruta con las opciones proporcionadas.Un único objeto de BuildQueryResult se devuelve de la consulta, con un BuildDetail enumerado la misma longitud que la matriz de URI de entrada.Si no coincide con un URI determinado ninguna compilaciones, el índice correspondiente de la lista resultante de BuildDetail será null.La cantidad de datos devueltos por la consulta se controla mediante el parámetro options.
Método público QueueBuild Intentos de enviar a la cola las compilaciones usando las solicitudes proporcionadas.Si la puesta en cola es correcta, una lista de las compilaciones en cola se devuelve.El QueueId de compilación en cola se puede utilizar para realizar consultas posteriores en el elemento para sondear.Si es el único en la cola a la hora de la puesta en cola y de estado es “activo establecido”. la compilación se iniciará inmediatamente.
Método público StopBuilds Detiene las compilaciones en curso con los URI proporcionados.Si una compilación se ha completado, se omitirá y consideraba correcta.El usuario que realiza esta llamada debe tener el permiso de AdministerBuild a todos los proyectos de equipo para los que detenga se están creando.
Método público ToString Devuelve un objeto String que contiene el nombre del objeto Component, en caso de que exista.Este método no debe reemplazarse. (Se hereda de MarshalByValueComponent).
Método público UpdateBuildAgents
Método público UpdateBuildDefinitions
Método público UpdateBuildInformation
Método público UpdateBuilds Detalles de la compilación de las actualizaciones con la información proporcionada.El usuario debe tener el permiso de AdministerBuild en el proyecto de equipo que contiene la compilación para realizar esta acción.
Método público UpdateQueuedBuilds Compilaciones en cola se actualiza con la información proporcionada.El usuario debe tener el permiso de AdministerBuild en el proyecto de equipo que contiene la compilación en cola para realizar esta acción.Este método es todo o nada, lo que significa que funcionan todas las actualizaciones o ninguno de ellos trabajo.Cambiar el marcador pospuesto de una compilación tarea puede que se iniciará.Por consiguiente, la propiedad de compilación del objeto de QueuedBuild se establecerá si se inicia la compilación.

Arriba

Eventos

  Nombre Descripción
Evento público Disposed Agrega un controlador de eventos para escuchar el evento Disposed en el componente. (Se hereda de MarshalByValueComponent).

Arriba

Seguridad para subprocesos

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Vea también

Referencia

Microsoft.TeamFoundation.Build.Server.Compatibility (Espacio de nombres)