ObjectReferenceTracker Classe

Definição

Namespace:

Microsoft.SqlServer.Dts.Runtime

Assembly:

Microsoft.SqlServer.ManagedDTS.dll

Fornece a análise relativa ao impacto e às consequências da exclusão de variáveis e conexões de um pacote. Essa classe não pode ser herdada.

public ref class ObjectReferenceTracker sealed : Microsoft::SqlServer::Dts::Runtime::DtsObject

public sealed class ObjectReferenceTracker : Microsoft.SqlServer.Dts.Runtime.DtsObject

type ObjectReferenceTracker = class
    inherit DtsObject

Public NotInheritable Class ObjectReferenceTracker
Inherits DtsObject

Herança

Object

DtsObject

ObjectReferenceTracker

Comentários

Esse ObjectReferenceTracker é um mecanismo para exibir a análise de impacto. Registre os objetos que seus componentes estão usando e onde eles são encontrados. Se outro usuário ou componente tentar excluir um objeto, o sistema poderá fornecer informações permitindo que você verifique se o objeto não está em uso em outro lugar e, se ele for usado em outro lugar, exiba as informações para você. Quando você adiciona ou exclui uma referência a uma variável de um componente ou pacote, você precisa atualizar as listas de referência de variável.

Atualmente, os tipos de objetos compatíveis com o rastreador de referência são listados na DTSObjectReferenceType enumeração.

Uma tarefa de runtime ou um componente de pipeline que usa variáveis ou coleções usa o AddReference método para criar uma lista de referência de objetos. Você também precisa fornecer um local de uso e uma descrição para a lista chamando SetListInfo. Por exemplo, uma tarefa com uma única variável usaria seu nome como as informações de local e uma descrição para o que a variável é usada como descrição de uso.

Tarefas ou componentes que fazem usos diferentes de variáveis ou conexões podem criar quantas listas de referência separadas forem necessárias. Por exemplo, o componente Divisão Condicional usa variáveis em expressões em saídas e você pode criar uma lista de referência separada para cada expressão de saída que usa variáveis. Defina o nome do componente como o local de uso e inclua a expressão e onde ela é encontrada na descrição. Se a mesma variável for usada em várias expressões, cada local de uso será rastreado pelo sistema.

Há enumerações separadas DTSObjectReferenceType para variáveis somente leitura e variáveis de leitura/gravação. O uso dessa especificação, em conjunto com o bloqueio de variáveis com a VariableDispenser classe, pode fornecer informações úteis ao resolver problemas de deadlock.

Métodos

AddReference(String, DTSObjectReferenceType, Int32)	Este método adiciona uma referência a uma lista para acompanhamento de referência.
DestroyList(Int32)	Este método destrói a lista de referências especificada do acompanhamento de referência.
Equals(Object)	Determina se duas instâncias de objeto são iguais. (Herdado de DtsObject)
GetHashCode()	Retorna o código hash para a instância. (Herdado de DtsObject)
RemoveReference(String, DTSObjectReferenceType, Int32)	Remove uma referência de uma lista existente.
SetListInfo(Int32, String, String)	Este método permite que você forneça metadados para uma lista de referências existente.