ObjectReferenceTracker.AddReference Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 -> unitPublic 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 .