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입니다.

설명

이 메서드는 지정된 형식을 사용하여 매개 변수에 objectNameOrID 명명된 refType개체에 대한 참조를 지정된 refListID참조 목록에 추가합니다. 목록을 만들려면 0을 전달합니다 refListID. 반환 refListID 되면 새로 만든 목록의 ID가 포함되며, 이제 단일 새 항목이 포함됩니다. 반환 refListID 된 항목은 후속 호출에서 동일한 목록에 더 많은 참조를 추가하는 데 사용할 수 있습니다.

이 메서드는 참조 추적기 시스템에서 전체 참조 목록을 제거합니다. 목록을 소유하는 개체가 제거될 때 호출되어야 합니다. 또한 목록을 소유하는 개체를 새로 고치고 새 목록을 만들어야 하는 경우에도 유용합니다. 예를 들어 조건부 분할 변환에서 출력의 식이 변경되면 해당 식에 대한 참조 목록이 제거되고 새 식이 구문 분석될 때 생성된 새 목록이 제거될 수 있습니다.

refListID 매개 변수는 메서드를 사용하여 AddReference 목록이 새로 생성될 때 만들어집니다. 메서드는 AddReference 사용자에게 refListID반환되며 새로 만든 목록의 ID를 포함합니다. 이 반환 refListID 은 후속 호출에서 동일한 목록에 더 많은 참조를 추가하거나, 목록에 대한 참조를 제거하거나, 목록을 삭제하거나, 메서드를 SetListInfo 사용할 때 사용할 수 있습니다.