Freigeben über


ObjectReferenceTracker.AddReference Methode

Definition

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 -> unit
Public 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.

Gilt für: