Share via


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.