ObjectReferenceTracker.AddReference Metodo

Definizione

Spazio dei nomi:

Microsoft.SqlServer.Dts.Runtime

Assembly:

Microsoft.SqlServer.ManagedDTS.dll

Questo metodo aggiunge un riferimento a un elenco per il rilevamento di riferimenti.

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)

Parametri

objectNameOrID

String

Nome o ID dell'oggetto proprietario dell'elenco al quale viene aggiunto un nuovo riferimento per il rilevamento.

refType

DTSObjectReferenceType

Tipo di riferimento da tenere traccia. I valori validi sono disponibili nell'enumerazione DTSObjectReferenceType .

refListID

Int32

ID dell'elenco di riferimenti.

Commenti

Questo metodo aggiunge un riferimento per l'oggetto denominato nel parametro, con il tipo specificato in objectNameOrIDrefType, all'elenco di riferimento con l'oggetto specificato refListID. Per creare un elenco, passare zero per refListID. Al ritorno, refListID conterrà l'ID dell'elenco appena creato, che ora contiene la singola voce nuova. Il restituito refListID può essere usato nelle chiamate successive per aggiungere altri riferimenti allo stesso elenco.

Questo metodo rimuove l'intero elenco di riferimenti dal sistema Reference Tracker. Deve essere chiamato quando l'oggetto proprietario di un elenco viene distrutto. È anche utile quando l'oggetto proprietario dell'elenco viene aggiornato e deve essere creato un nuovo elenco. Ad esempio, nella trasformazione Split condizionale, se l'espressione in un output viene modificata, l'elenco di riferimento per tale espressione può essere eliminato e un nuovo elenco creato come nuova espressione viene analizzato.

Il refListID parametro viene creato quando l'elenco viene appena generato usando il AddReference metodo . Il AddReference metodo restituisce a un refListIDoggetto e contiene l'ID dell'elenco appena creato. Questa restituzione refListID può essere usata nelle chiamate successive per aggiungere altri riferimenti allo stesso elenco, rimuovere riferimenti all'elenco, eliminare un elenco o quando si usa il SetListInfo metodo .