ObjectReferenceTracker.AddReference Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 -> unitPublic 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.