## XSICollection.Add

### Description

Adds a single item to a collection. Compare this method to XSICollection.AddItems, which adds one or more items at a time or XSICollection.SetAsText, which adds all items in the string list.

### C# Syntax

    XSICollection.Add( Object in_newVal );

### Scripting Syntax

    XSICollection.Add( Item );

### Parameters

Parameter | Type | Description
--- | --- | ---
Item | CollectionItem, any kind of ProjectItem or String | The new item being added. This may be a generic object (CollectionItem), a specific type of object (ProjectItem) or an Object Name (string expression).

### Examples

#### VBScript Example

    Dim oColl		' object pointer for collection

    Dim oMember		' object pointer for members

    Dim oNull		' object pointer for null object

    Dim oCollItem	' object pointer for collection item

    Dim sLightName	' string variable for the camera name

    ' Create the stuff we will populate the collection with

    Set oNull = ActiveSceneRoot.AddNull

    checkType oNull			' = project item

    Set oCollItem = CreateObject( "XSI.CollectionItem" )

    oCollItem.Value = "Camera"

    checkType oCollItem			' = collection item

    sLightName = "light*"

    checkType sLightName			' = string expression

    ' Create the new collection

    Set oColl = CreateObject( "XSI.Collection" )

    ' Add each item

    oColl.Add oNull

    oColl.Add oCollItem

    oColl.Add sLightName

    ' What do we have now?

    LogMessage "----------------"

    For Each oMember In oColl

    	checkType oMember

    Next

    '--------------------------------------------------

    function checkType( in_object )

    	LogMessage in_object & " is a " & TypeName( in_object )

    end function

    '--------------------------------------------------

    ' Output of above script:

    'INFO : "null is a Null"

    'INFO : "Camera is a CollectionItem"

    'INFO : "light* is a String"

    'INFO : "----------------"

    'INFO : "null is a Null"

    'INFO : "Camera is a Camera"

    'INFO : "light is a Light"

### See Also

XSICollection.GetAsText XSICollection.AddItems XSICollection.Remove