ObjectReferenceTracker.AddReference Méthode
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.
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 refType
avec 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.