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. Esta 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
O ObjectReferenceTracker é um mecanismo para exibir a análise de impacto. Você registra 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 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 com suporte no controlador de referência são listados na DTSObjectReferenceType enumeração.
Uma tarefa de tempo de execução 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 localização e uma descrição do que a variável é usada como a descrição de uso.
Tarefas ou componentes que fazem uso diferente de variáveis ou conexões podem criar quantas listas de referência separadas forem necessárias. Por exemplo, o componente de 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. Você define o nome do componente como o local de uso e inclui a expressão e onde ele é encontrado na descrição. Se a mesma variável for usada em várias expressões, cada local de uso será acompanhado pelo sistema.
Há DTSObjectReferenceType enumerações separadas para variáveis somente leitura e variáveis de leitura/gravação. Usar essa especificação, em conjunto com o bloqueio de variável 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. |