ObjectReferenceTracker Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit une analyse concernant l'impact et les conséquences de la suppression des variables et des connexions d'un package. Cette classe ne peut pas être héritée.
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- Héritage
Remarques
Il ObjectReferenceTracker s’agit d’un mécanisme permettant d’afficher l’analyse d’impact. Vous inscrivez les objets que vos composants utilisent et où ils sont trouvés. Si un autre utilisateur ou composant tente de supprimer un objet, le système peut fournir des informations vous permettant de vérifier que l’objet n’est pas utilisé ailleurs et s’il est utilisé ailleurs, affichez les informations à vous. Lorsque vous ajoutez ou supprimez une référence à une variable d’un composant ou d’un package, vous devez mettre à jour les listes de référence de variable.
Actuellement, les types d’objets pris en charge par le suivi de référence sont répertoriés dans l’énumération DTSObjectReferenceType .
Une tâche runtime ou un composant de pipeline qui utilise des variables ou des collections utilise la AddReference méthode pour créer une liste de référence d’objets. Vous devez également fournir un emplacement d’utilisation et une description pour la liste en appelant SetListInfo. Par exemple, une tâche avec une variable unique utilise son nom comme informations d’emplacement et une description de ce que la variable est utilisée comme description de l’utilisation.
Les tâches ou composants qui utilisent différentes variables ou connexions peuvent créer autant de listes de référence distinctes que nécessaire. Par exemple, le composant Fractionnement conditionnel utilise des variables dans des expressions sur des sorties, et vous pouvez créer une liste de référence distincte pour chaque expression de sortie qui utilise des variables. Vous définissez le nom du composant comme emplacement d’utilisation et incluez l’expression et l’emplacement où il se trouve dans la description. Si la même variable est utilisée dans plusieurs expressions, chaque emplacement d’utilisation est suivi par le système.
Il existe des énumérations distinctes DTSObjectReferenceType pour les variables en lecture seule et les variables en lecture/écriture. À l’aide de cette spécification, conjointement avec le verrouillage des variables avec la classe, vous pouvez fournir des informations utiles lors de la VariableDispenser résolution des problèmes de blocage.
Méthodes
| AddReference(String, DTSObjectReferenceType, Int32) |
Cette méthode ajoute une référence à une liste de suivi de référence. |
| DestroyList(Int32) |
Cette méthode détruit la liste de références spécifiée du suivi de référence. |
| Equals(Object) |
Détermine si les deux instances d'objet sont égales. (Hérité de DtsObject) |
| GetHashCode() |
Retourne le code de hachage de cette instance. (Hérité de DtsObject) |
| RemoveReference(String, DTSObjectReferenceType, Int32) |
Supprime une référence d'une liste existante. |
| SetListInfo(Int32, String, String) |
Cette méthode vous permet de fournir des métadonnées à une liste de références existante. |