Instances

Example

Filter objects

You can filter out objects that are of no interest to your analysis by type or string value .

You can make your search more efficient by using the following tips:

• Use CamelHumps. E.g. fo will return objects of both System.Drawing.Font and MS.Utility.FrugalObjectList types.

• For instances of the String type, you can search by the string value. Type any string value into the filter field, and dotMemory will highlight matching strings.

• For string values, you can use regular expressions. For example, ^Client.* will match all strings that start with Client like ClientRequest or ClientController.

• You can also search for object instances by their memory address. This is useful for tracking specific objects directly.

• Use special symbols, like wildcards and others. The full list is shown in the table below.

Special symbols and filter examples

Symbol	Description	Example
*	Wildcard	* All objects in the set
		sys.*.data All types and namespaces that match the pattern. E.g. System.Data, System.Windows.Controls.Datagrid, and System.Windows.Data.Binding.
		sys.*.data. Only namespaces that match the pattern. E.g. System.Windows.Data.Binding but not System.Windows.Controls.Datagrid.
Arrays
[]	Leave only arrays	str[] Arrays, containing str in their type or namespace. E.g. String[].
[, [,, ... or [,] [,,] ...	Leave only arrays of the specified or higher (if brackets are not closed) dimension	str[,, Arrays with the dimension 3 and higher containing str in their type or namespace. E.g. String[,,] and String[,,,].
		str[,,] Three-dimensional arrays containing str in their type or namespace. E.g. String[,,].
!a	Exclude arrays from the result	!a str Objects (excluding arrays) containing str in their type or namespace. E.g. String but not String[].
Ranked arrays
[N.. [N..] [N..M] [N..M, X..Y] ... where N, M, X, Y are integers	Leave only arrays with the specified number of elements	byte[10..100] Arrays with Byte in their type or namespace with 10 - 100 number of elements. E.g. Byte[98].
		byte[10..100, 25.. Two- (or more) dimensional arrays with Byte in their type or namespace with 10 - 100 number of elements in the first dimension and more than 25 elements in the second. E.g. Byte[98, 30, 1000] but not Byte[98].
		If range is not specified, the filter is treated as a text filter. For example, byte[1 will match Byte[195] and Byte[1, 50]. byte[1*5] will match Byte[13853].
Generic type arguments
<	Leave only types with generic type arguments	str< Only objects containing str in their type or namespace and having generic type arguments. E.g. FileStreamStorage<Char> but not List<String>.
		<str Only objects containing str in their generic type arguments. E.g. List<String> but not FileStreamStorage<Char>.
<, <,, ... or <,> <,,> ...	Leave only objects with the specified number of generic type arguments	fun<,,> Objects containing fun in their type or namespace and having three generic type arguments. E.g. Func<String, Object, Object>.
		fun<str,,task Objects containing fun in their type or namespace and having three or generic type arguments that match the pattern. E.g. Func<Stream, IAsyncResult, TaskResult, EventArgs>.
!g	Exclude generic type arguments from the search scope	!g str Objects (that do not have generic type arguments) containing str in their type or namespace. E.g. String but not List<String>.
#c #struct #m #ns	Search by type, value type, method, or namespace.	#ns Feature Objects containing Feature in their namespace.

Select objects for further analysis

In the Instances view, you can select the following subjects for further analysis:

• An instance;

• Objects exclusively retained (dominated) by the whole object set.