IVsDataViewHierarchy.DelayInsertItem Method (String, String, 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, _
    typeName As String, _
    newItemId As Integer, _
    identifier As Object() _
) As Boolean

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

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

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

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

Parameters

• parentFullName
  Type: System.String

  The full name of the new node's parent.

• typeName
  Type: System.String

  The name of the new node's type.

• 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 typeName 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