ObjectReferenceTracker.AddReference Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> unitPublic 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 .