ObjectReferenceTracker.AddReference Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Diese Methode fügt einer Liste zur Verweisnachverfolgung einen Verweis hinzu.
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 -> unitPublic Sub AddReference (objectNameOrID As String, refType As DTSObjectReferenceType, ByRef refListID As Integer)Parameter
- objectNameOrID
- String
Der Objektname oder die ID des Objekts, das im Besitz der Liste ist, der Sie einen neuen Verweis zur Nachverfolgung hinzufügen.
- refType
- DTSObjectReferenceType
Der Typ des Verweises, den Sie nachverfolgen möchten. Die gültigen Werte werden in der DTSObjectReferenceType Aufzählung gefunden.
- refListID
- Int32
Die ID der Verweisliste.
Hinweise
Diese Methode fügt einen Verweis für das im Parameter benannte objectNameOrID Objekt mit dem angegebenen Typ zur Referenzliste mit dem angegebenen refTyperefListIDWert hinzu. Um eine Liste zu erstellen, übergeben Sie null für refListID. Nach der Rückgabe refListID enthält die ID der neu erstellten Liste, die jetzt den einzelnen neuen Eintrag enthält. Die zurückgegebene refListID Kann in nachfolgenden Aufrufen verwendet werden, um weitere Verweise auf dieselbe Liste hinzuzufügen.
Diese Methode entfernt die gesamte Referenzliste aus dem Reference Tracker-System. Es sollte aufgerufen werden, wenn das Objekt, das eine Liste besitzt, zerstört wird. Es ist auch nützlich, wenn das Objekt, das die Liste besitzt, aktualisiert wird, und eine neue Liste erstellt werden muss. Wenn z. B. der Ausdruck einer Ausgabe geändert wird, kann die Referenzliste für diesen Ausdruck zerstört werden, und eine neue Liste, die als neuer Ausdruck erstellt wurde, analysiert wird.
Der refListID Parameter wird erstellt, wenn die Liste neu mithilfe der AddReference Methode generiert wird. Die AddReference Methode gibt an Sie zurück refListIDund enthält die ID der neu erstellten Liste. Diese zurückgegebene refListID Kann in nachfolgenden Aufrufen verwendet werden, um weitere Verweise auf dieselbe Liste hinzuzufügen, Verweise auf die Liste zu entfernen, eine Liste zu zerstören oder wenn sie die SetListInfo Methode verwenden.