ObjectReferenceTracker.AddReference Método

Definición

Espacio de nombres:

Microsoft.SqlServer.Dts.Runtime

Ensamblado:

Microsoft.SqlServer.ManagedDTS.dll

Este método agrega una referencia a una lista para el seguimiento de referencias.

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)

Parámetros

objectNameOrID

String

El nombre de objeto o el identificador del objeto que posee la lista a la que está agregando una nueva referencia para su seguimiento.

refType

DTSObjectReferenceType

Tipo de referencia que desea realizar. Los valores válidos se encuentran en la DTSObjectReferenceType enumeración .

refListID

Int32

El identificador de la lista de referencias.

Comentarios

Este método agrega una referencia para el objeto denominado en el objectNameOrID parámetro , con el tipo especificado en refType, a la lista de referencias con el especificado refListID. Para crear una lista, pase cero para refListID. Tras la devolución, refListID contendrá el identificador de la lista recién creada, que ahora contiene la única entrada nueva. El devuelto refListID se puede usar en llamadas posteriores para agregar más referencias a la misma lista.

Este método quita toda la lista de referencias del sistema Reference Tracker. Debe llamarse cuando se destruye el objeto que posee una lista. También es útil cuando se actualiza el objeto propietario de la lista y se debe crear una nueva lista. Por ejemplo, en la transformación División condicional, si se cambia la expresión en una salida, se puede destruir la lista de referencias de esa expresión y se analiza una nueva lista creada a medida que se analiza la nueva expresión.

El refListID parámetro se crea cuando la lista se genera recientemente mediante el AddReference método . El AddReference método devuelve un refListIDy contiene el identificador de la lista recién creada. Esto devuelto refListID se puede usar en llamadas posteriores para agregar más referencias a la misma lista, quitar referencias a la lista, destruir una lista o cuando se usa el SetListInfo método .