TrackingService Classe

Definição

Namespace:

System.Workflow.Runtime.Tracking

Assembly:

System.Workflow.Runtime.dll

Cuidado

The System.Workflow.* types are deprecated. Instead, please use the new types from System.Activities.*

Fornece a interface básica entre um serviço de acompanhamento e a infraestrutura de acompanhamento de tempo de execução.

public ref class TrackingService abstract : System::Workflow::Runtime::Hosting::WorkflowRuntimeService

[System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")]
public abstract class TrackingService : System.Workflow.Runtime.Hosting.WorkflowRuntimeService

[<System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")>]
type TrackingService = class
    inherit WorkflowRuntimeService

Public MustInherit Class TrackingService
Inherits WorkflowRuntimeService

Herança

Object

WorkflowRuntimeService

TrackingService

Derivado

System.Workflow.Runtime.Tracking.SqlTrackingService

Atributos

ObsoleteAttribute

Comentários

Observação

Este material discute tipos e namespaces obsoletos. Para obter mais informações, consulte Deprecated Types in Windows Workflow Foundation 4.5 (Tipos preteridos no Windows Workflow Foundation 4.5).

Um serviço de acompanhamento é responsável por fornecer canais de acompanhamento e perfis de rastreamento para o mecanismo de tempo de execução do fluxo de trabalho. O mecanismo de tempo de execução do fluxo de trabalho solicita um TrackingChannel de um serviço de acompanhamento para cada instância de fluxo de trabalho para a qual ele tem um TrackingProfile. O mecanismo de tempo de execução de fluxo de trabalho usa isso TrackingChannel para enviar registros de rastreamento associados a essa instância de fluxo de trabalho. Um TrackingProfile contém pontos de faixa que especificam um conjunto de eventos de acompanhamento para os quais a infraestrutura de acompanhamento em tempo de execução deve enviar registros de rastreamento. Um TrackingProfile também pode especificar dados a serem extraídos da instância de fluxo de trabalho quando ocorre um desses eventos de acompanhamento.

A infraestrutura de acompanhamento em tempo de execução usa um TrackingProfile para filtrar eventos de rastreamento emitidos por uma instância de fluxo de trabalho. Quando um evento de acompanhamento é emitido que corresponde a TrackingProfileum ponto de acompanhamento no , a infraestrutura de acompanhamento em tempo de execução extrai todos os dados especificados no TrackingProfile da instância de fluxo de trabalho e encapsula esses dados e informações sobre o evento de acompanhamento em um registro de acompanhamento. Esse registro de acompanhamento é enviado pelo TrackingChannel associado à instância de fluxo de trabalho. Um registro de acompanhamento pode ser um dos seguintes tipos:

ActivityTrackingRecord

UserTrackingRecord

WorkflowTrackingRecord

O aplicativo host pode usar o registro de acompanhamento da maneira que ele escolher. Por exemplo, o aplicativo host pode armazenar as informações de acompanhamento em um banco de dados e usá-lo para implementar uma interface do usuário sofisticada ou pode usar as informações para informar um administrador de uma condição que requer alguma ação. Você pode registrar um serviço de acompanhamento com o mecanismo de tempo de execução do fluxo de trabalho chamando WorkflowRuntime.AddService ou incluindo a entrada apropriada no arquivo de configuração do aplicativo.

Todos os serviços de acompanhamento devem herdar da TrackingService classe abstrata. Essa classe define a interface básica entre um serviço de acompanhamento e a infraestrutura de acompanhamento em tempo de execução. O mecanismo de tempo de execução do fluxo de trabalho solicita um TrackingProfile para uma instância de fluxo de trabalho ou fluxo Type de trabalho específico chamando um dos métodos sobrecarregados GetProfile ou o TryGetProfile método . O mecanismo de tempo de execução do fluxo de trabalho chama GetTrackingChannel para solicitar um TrackingChannel.

O runtime de acompanhamento de fluxo de trabalho chama os GetProfile métodos e TryGetProfile sempre que uma instância de fluxo de trabalho é criada ou carregada do repositório de persistência. A sobrecarga associada a essas chamadas pode ser cara para o serviço de acompanhamento (muitas chamadas de banco de dados, por exemplo). Você pode implementar a IProfileNotification interface em seu serviço de acompanhamento para contornar esse mecanismo baseado em chamada e usar eventos para notificar o mecanismo de runtime de fluxo de trabalho de alterações em um TrackingProfile. Para acompanhar os serviços que implementam a IProfileNotification interface , o mecanismo de tempo de execução do fluxo de trabalho assina os ProfileUpdated eventos e ProfileRemoved . Seu serviço de acompanhamento pode gerar o evento apropriado quando ocorre uma alteração em um de seus perfis de acompanhamento. A SqlTrackingService classe implementa essa interface.

O mecanismo de tempo de execução do fluxo de trabalho chama o TryReloadProfile método para testar se um TrackingProfile foi atualizado ou removido como resultado de uma chamada explícita por um host ou um serviço para ReloadTrackingProfiles em uma instância de fluxo de trabalho. Esse processo permite que um host ou serviço altere dinamicamente o perfil de acompanhamento que está sendo usado para uma instância de fluxo de trabalho específica.

Notas aos Implementadores

• Ao herdar de TrackingService, você deve substituir os seguintes membros: GetProfile(Guid)

• GetProfile(Type, Version)

• TryGetProfile(Type, TrackingProfile)

• GetTrackingChannel(TrackingParameters)

• TryReloadProfile(Type, Guid, TrackingProfile)

Construtores

TrackingService()

Obsoleto. Quando implementado em uma classe derivada, inicializa uma nova instância da classe TrackingService.

Propriedades

Runtime	Obsoleto. Obtém o WorkflowRuntime para este serviço. (Herdado de WorkflowRuntimeService)
State	Obsoleto. Obtém o estado do WorkflowRuntimeService. (Herdado de WorkflowRuntimeService)

Métodos

Equals(Object)	Obsoleto. Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Obsoleto. Serve como a função de hash padrão. (Herdado de Object)
GetProfile(Guid)	Obsoleto. Deve ser substituído na classe derivada e, quando implementado, retorna o perfil de acompanhamento para a instância de fluxo de trabalho especificada.
GetProfile(Type, Version)	Obsoleto. Deve ser substituído na classe derivada e, quando implementado, retorna o perfil de acompanhamento, qualificado pela versão, para o Type do fluxo de trabalho especificado.
GetTrackingChannel(TrackingParameters)	Obsoleto. Deve ser substituído na classe derivada e, quando implementado, retorna o canal que a infraestrutura de acompanhamento de tempo de execução usa para enviar os registros de acompanhamento para o serviço de acompanhamento.
GetType()	Obsoleto. Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Obsoleto. Cria uma cópia superficial do Object atual. (Herdado de Object)
OnStarted()	Obsoleto. Quando substituído em uma classe derivada, representa o método que será chamado quando o mecanismo de runtime de fluxo de trabalho gerar o evento Started. (Herdado de WorkflowRuntimeService)
OnStopped()	Obsoleto. Quando substituído em uma classe derivada, representa o método que será chamado quando o mecanismo de runtime de fluxo de trabalho gerar o evento Stopped. (Herdado de WorkflowRuntimeService)
RaiseServicesExceptionNotHandledEvent(Exception, Guid)	Obsoleto. Aciona o evento ServicesExceptionNotHandled. (Herdado de WorkflowRuntimeService)
Start()	Obsoleto. Quando substituído em uma classe derivada, inicia o serviço e altera o State para Starting. (Herdado de WorkflowRuntimeService)
Stop()	Obsoleto. Quando substituído em uma classe derivada, interrompe o serviço e altera o State para Stopping. (Herdado de WorkflowRuntimeService)
ToString()	Obsoleto. Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
TryGetProfile(Type, TrackingProfile)	Obsoleto. Deve ser substituído na classe derivada e, quando implementado, recupera o perfil de acompanhamento do tipo de fluxo de trabalho especificado, se houver um disponível.
TryReloadProfile(Type, Guid, TrackingProfile)	Obsoleto. Deve ser substituído na classe derivada e, quando implementado, recupera um novo perfil de acompanhamento para a instância de fluxo de trabalho especificada se o perfil de acompanhamento tiver sido alterado desde a última vez em que foi carregado.

Confira também

• IProfileNotification