References/Wraps

The References/Wraps tree is only available for managed type instances and shows a tree of all references from the selected instance, i.e., the values of all non-null reference fields. If the instance wraps any resource instance, the tree also contains all resource instances that are wrapped by the selected instance. For more information, see ­Wrapped by. If the instance does not wrap any resource instances (or the native resource tracker is not enabled), the page name is only “References.”

The details of a reference can be viewed by double-clicking an entry in this list. The list can be sorted by clicking on the column headers. The following information is presented for each entry in this list:

• Field
  This column shows the name of the field (or fields) that contains the reference or the wrapped resource identifier.

• Type/Resource
  This column shows the type name of the instance referenced by the selected instance, or the resource name if the field wraps a native resource instance.

• Instance
  This column shows the instance number of the instance referenced by the selected instance.

• Instance bytes
  This column shows the number of bytes used by the referenced instance.

• Held instances
  This column shows the number of instances that are held by referenced the instance. This column is not included by default, but can be included by customizing the columns.

• Held bytes
  This column shows the number of bytes that are used by instances that are held by the referenced instance.

• Reachable instances
  This column shows the number of instances that are reachable from the referenced instance. This column is not included by default, but can be included by customizing the columns.

• Reachable bytes
  This column shows the number of bytes that are used by instances that are reachable from the referenced instance. This column is not included by default, but can be included by customizing the columns.

For more information about held and reachable instances, see Held and Reachable Instances..

It is possible to expand each instance in the References tree, to get information about the next level of references.

Only include held instances

If the Only include held instances checkbox is checked, only instances that are held by the selected instance is included in the references tree. Additionally, each held instance will only be included once in the tree, which will prevent cycles to be included in the tree. (e.g., if the Only include held instances is checked and a held instance has a reference back to the selected instance, this reference will not be presented in the tree).

Using this option provides the possibility to investigate the memory used exclusively by the selected instance.