IVsDataViewHierarchy.DelayInsertItem Method (String, IVsDataViewSelectionInfo, Int32, array<Object )

Adds the specified node to the queue of nodes to be inserted at a later time, if the parent node has not been expanded yet or is not created. Otherwise, inserts the specified node immediately.

Namespace:  Microsoft.VisualStudio.Data.Services.SupportEntities
Assembly:  Microsoft.VisualStudio.Data.Services (in Microsoft.VisualStudio.Data.Services.dll)

Syntax

'Declaration
Function DelayInsertItem ( _
    parentFullName As String, _
    childSelectionInfo As IVsDataViewSelectionInfo, _
    newItemId As Integer, _
    identifier As Object() _
) As Boolean

bool DelayInsertItem(
    string parentFullName,
    IVsDataViewSelectionInfo childSelectionInfo,
    int newItemId,
    Object[] identifier
)

bool DelayInsertItem(
    String^ parentFullName, 
    IVsDataViewSelectionInfo^ childSelectionInfo, 
    int newItemId, 
    array<Object^>^ identifier
)

abstract DelayInsertItem : 
        parentFullName:string * 
        childSelectionInfo:IVsDataViewSelectionInfo * 
        newItemId:int * 
        identifier:Object[] -> bool

function DelayInsertItem(
    parentFullName : String, 
    childSelectionInfo : IVsDataViewSelectionInfo, 
    newItemId : int, 
    identifier : Object[]
) : boolean

Parameters

• parentFullName
  Type: System.String

  The full name of the new node's parent.

• childSelectionInfo
  Type: Microsoft.VisualStudio.Data.Services.IVsDataViewSelectionInfo

  The selection of child nodes to insert beneath the new node.

• newItemId
  Type: System.Int32

  A numerical identifier for the new node to insert.

• identifier
  Type: array<System.Object[]

  An array containing identifier parts that represent the new node.

Return Value

Type: System.Boolean
true if the new node is inserted immediately; false if the new node is placed in queue for delayed insert or is not inserted immediately.

Exceptions

Exception	Condition
ArgumentNullException	The parentFullName or childSelectionInfo parameter is nulla null reference (Nothing in Visual Basic).

Remarks

This method improves performance because the new node is inserted only when the parent node is expanded, thereby reducing the number of enumerations performed on the tree.

.NET Framework Security

• Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

See Also

Reference

IVsDataViewHierarchy Interface

DelayInsertItem Overload

Microsoft.VisualStudio.Data.Services.SupportEntities Namespace