ObjectReferenceTracker Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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::DtsObjectpublic sealed class ObjectReferenceTracker : Microsoft.SqlServer.Dts.Runtime.DtsObjecttype ObjectReferenceTracker = class
inherit DtsObjectPublic NotInheritable Class ObjectReferenceTracker
Inherits DtsObject- Herança
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. |