Partager via


ObjectReferenceTracker.AddReference Méthode

Définition

Cette méthode ajoute une référence à une liste de suivi de référence.

public:
 void AddReference(System::String ^ objectNameOrID, Microsoft::SqlServer::Dts::Runtime::DTSObjectReferenceType refType, int % refListID);
public void AddReference (string objectNameOrID, Microsoft.SqlServer.Dts.Runtime.DTSObjectReferenceType refType, ref int refListID);
member this.AddReference : string * Microsoft.SqlServer.Dts.Runtime.DTSObjectReferenceType * int -> unit
Public Sub AddReference (objectNameOrID As String, refType As DTSObjectReferenceType, ByRef refListID As Integer)

Paramètres

objectNameOrID
String

Nom de l'objet ou ID de l'objet qui possède la liste à laquelle vous ajoutez une nouvelle référence pour le suivi.

refType
DTSObjectReferenceType

Type de référence que vous souhaitez suivre. Les valeurs valides sont trouvées dans l’énumération DTSObjectReferenceType .

refListID
Int32

ID de la liste de références.

Remarques

Cette méthode ajoute une référence pour l’objet nommé dans le objectNameOrID paramètre, avec le type spécifié dans , à la liste de références refTypeavec l’élément donné refListID. Pour créer une liste, passez zéro pour refListID. Lors du retour, refListID contient l’ID de la liste nouvellement créée, qui contient désormais la nouvelle entrée. Le retour refListID peut être utilisé dans les appels suivants pour ajouter d’autres références à la même liste.

Cette méthode supprime la liste de références entière du système Reference Tracker. Il doit être appelé lorsque l’objet propriétaire d’une liste est détruit. Il est également utile lorsque l’objet propriétaire de la liste est actualisé et qu’une nouvelle liste doit être créée. Par exemple, dans la transformation de fractionnement conditionnel, si l’expression d’une sortie est modifiée, la liste de référence de cette expression peut être détruite et une nouvelle liste créée en tant qu’expression est analysée.

Le refListID paramètre est créé lorsque la liste est nouvellement générée à l’aide de la AddReference méthode. La AddReference méthode vous renvoie un refListID, et contient l’ID de la liste nouvellement créée. Ce retour refListID peut être utilisé dans les appels suivants pour ajouter d’autres références à la même liste, supprimer des références à la liste, détruire une liste ou quand vous utilisez la SetListInfo méthode.

S’applique à