ObjectReferenceTracker.AddReference Método

Definição

Namespace:

Microsoft.SqlServer.Dts.Runtime

Assembly:

Microsoft.SqlServer.ManagedDTS.dll

Este método adiciona uma referência a uma lista para acompanhamento de referência.

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

O nome ou a ID do objeto que possui a lista à qual você está adicionando uma nova referência para rastreamento.

refType

DTSObjectReferenceType

O tipo de referência que você deseja rastrear. Os valores válidos são encontrados na DTSObjectReferenceType enumeração.

refListID

Int32

A ID da lista de referência.

Comentários

Esse método adiciona uma referência para o objeto nomeado no objectNameOrID parâmetro, com o tipo especificado, refTypeà lista de referência com o determinado refListID. Para criar uma lista, passe zero para refListID. Após o retorno, refListID conterá a ID da lista recém-criada, que agora contém a única nova entrada. O retornado refListID pode ser usado em chamadas subsequentes para adicionar mais referências à mesma lista.

Esse método remove toda a lista de referências do sistema do Rastreador de Referência. Ele deve ser chamado quando o objeto que possui uma lista está sendo destruído. Também é útil quando o objeto que possui a lista está sendo atualizado e uma nova lista deve ser criada. Por exemplo, na transformação Divisão Condicional, se a expressão em uma saída for alterada, a lista de referência para essa expressão poderá ser destruída e uma nova lista criada à medida que a nova expressão for analisada.

O refListID parâmetro é criado quando a lista é gerada recentemente usando o AddReference método. O AddReference método retorna a você um refListIDe contém a ID da lista recém-criada. Isso retornado refListID pode ser usado em chamadas subsequentes para adicionar mais referências à mesma lista, remover referências à lista, destruir uma lista ou ao usar o SetListInfo método.