ObjectReferenceTracker.SetListInfo Method
This method allows you to provide metadata for an existing reference list.
Namespace: Microsoft.SqlServer.Dts.Runtime
Assembly: Microsoft.SqlServer.ManagedDTS (in Microsoft.SqlServer.ManagedDTS.dll)
Syntax
'Declaration
Public Sub SetListInfo ( _
refListID As Integer, _
usageLocation As String, _
usageDescription As String _
)
'Usage
Dim instance As ObjectReferenceTracker
Dim refListID As Integer
Dim usageLocation As String
Dim usageDescription As String
instance.SetListInfo(refListID, usageLocation, _
usageDescription)
public void SetListInfo(
int refListID,
string usageLocation,
string usageDescription
)
public:
void SetListInfo(
int refListID,
String^ usageLocation,
String^ usageDescription
)
member SetListInfo :
refListID:int *
usageLocation:string *
usageDescription:string -> unit
public function SetListInfo(
refListID : int,
usageLocation : String,
usageDescription : String
)
Parameters
- refListID
Type: System.Int32
The list ID in which the object is currently located.
- usageLocation
Type: System.String
The location where the object is used.
- usageDescription
Type: System.String
A description that explains where the object is being used.
Remarks
After a new reference list is created, this method should be used to set the initial metadata. It is unlikely that the usageLocation property will change, but it possible to update both usageLocation and usageDescription properties as often as necessary.
The usageLocation is usually the name of the task or component that owns the list. This usageDescription is intended to give more detailed descriptions of how the objects in the list are used.
The refListID parameter is created when the list is newly generated using the AddReference method. The AddReference method returns to you a refListID, and it contains the ID of the newly created list. This returned refListID can be used in subsequent calls to add more references to the same list, remove references to the list, destroy a list, or when using the SetListInfo method.