ObjectReferenceTracker.AddReference 메서드

정의

네임스페이스:

Microsoft.SqlServer.Dts.Runtime

어셈블리:

Microsoft.SqlServer.ManagedDTS.dll

이 방법은 참조 추적을 위한 목록에 참조를 추가합니다.

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)

매개 변수

objectNameOrID

String

추가하려는 리스트를 소유한 객체 이름이나 ID가 새로운 참조로 추적됩니다.

refType

DTSObjectReferenceType

추적하고 싶은 참고 자료의 유형. 유효한 값은 열거에서 DTSObjectReferenceType 찾을 수 있습니다.

refListID

Int32

참고 문헌 목록의 ID입니다.

설명

이 방법은 매개변수refListID에 명시된 objectNameOrID 객체에 대한 참조를 , 에서 지정refType한 타입으로 참조 목록에 추가합니다. 리스트를 만들려면 에 대해 0 refListID을 전달하세요. 반환 시 는 refListID 새로 생성된 목록의 ID를 포함하며, 그 목록에는 이제 단일 새 항목이 포함됩니다. 반환 refListID 된 값은 이후 호출에서 동일한 목록에 더 많은 참조를 추가하는 데 사용할 수 있습니다.

이 방법은 참조 추적 시스템에서 전체 참조 목록을 제거합니다. 리스트를 소유한 객체가 파괴될 때 호출되어야 합니다. 또한 리스트를 소유한 객체가 새로고침될 때 새 리스트를 생성해야 할 때도 유용합니다. 예를 들어, 조건부 분할 변환에서는 출력에 대한 표현식이 변경되면 해당 표현식의 참조 목록을 파괴하고 새 표현식이 파싱될 때 새로운 리스트가 생성될 수 있습니다.

이 매개변수는 refListID 이 메서드를 사용해 AddReference 리스트를 새로 생성할 때 생성됩니다. 메서드는 AddReference a refListID를 반환하며, 새로 생성된 목록의 ID를 포함합니다. 이 반환 refListID 은 이후 호출에서 동일한 목록에 더 많은 참조를 추가하거나, 리스트에 대한 참조를 제거하거나, 리스트를 소기하거나, 메서드를 SetListInfo 사용할 때 사용할 수 있습니다.