ObjectReferenceTracker.AddReference Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Этот метод добавляет ссылку на список для отслеживания ссылок.
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
Имя или идентификатор объекта, владеющего списком, в который добавляется новая ссылка для отслеживания.
- refType
- DTSObjectReferenceType
Тип ссылки, которую требуется отслеживать. Допустимые значения находятся в перечислении DTSObjectReferenceType .
- refListID
- Int32
Идентификатор списка ссылок.
Комментарии
Этот метод добавляет ссылку на объект, названный в objectNameOrID
параметре, с типом, указанным в , в refType
список ссылок с заданным refListID
. Чтобы создать список, передайте ноль для refListID
. По возвращении refListID
будет содержать идентификатор только что созданного списка, который теперь содержит одну новую запись. Возвращаемый refListID
объект можно использовать в последующих вызовах для добавления дополнительных ссылок в тот же список.
Этот метод удаляет весь список ссылок из системы отслеживания ссылок. Его следует вызывать при уничтожении объекта, которому принадлежит список. Также полезно при обновлении объекта, которому принадлежит список, и необходимо создать новый список. Например, в преобразовании условного разбиения, если выражение выходных данных изменено, можно уничтожить список ссылок для этого выражения и создать новый список, созданный при анализе нового выражения.
Параметр refListID
создается при создании списка с помощью AddReference метода. Метод AddReference возвращается к вам refListID
и содержит идентификатор только что созданного списка. Это возвращается refListID
в последующих вызовах для добавления дополнительных ссылок в тот же список, удаления ссылок на список, уничтожения списка или при использовании SetListInfo метода.