Analyze memory usage

To find memory leaks and inefficient memory usage, you can use tools such as the debugger-integrated Memory Usage diagnostic tool or tools in the Performance Profiler such as the .NET Object Allocation tool and the post-mortem Memory Usage tool.

The Memory Usage tool lets you take one or more snapshots of the managed and native memory heap. You can collect snapshots of .NET, ASP.NET, C++, or mixed mode (.NET and native) apps. The Memory Usage tool can run on an open Visual Studio project, on an installed Microsoft Store app, or attached to a running app or process. You can run the Memory Usage tool with or without debugging. For more information, see Run profiling tools with or without the debugger. In the debugger, you can turn memory profiling on and off, and see a per-object breakdown of memory usage. You can view memory usage results when execution is paused, for example at a breakpoint.

.NET developers may choose between either the .NET Object Allocation tool or the Memory usage tool.

• The .NET Object Allocation tool helps you identify allocation patterns and anomalies in your .NET code, and helps identify common issues with garbage collection. This tool runs only as a post-mortem tool. You can run this tool on local or remote machines.
• The Memory Usage tool is helpful in identifying memory leaks, which are not typically common in .NET apps. If you need to use debugger features while checking memory, such as stepping through code, the debugger-integrated Memory usage tool is recommended.

C++ developers can use either the debugger-integrated or non-debugger Memory Usage tool.

You can use the profiling tools without the debugger with Windows 7 and later. Windows 8 and later is required to run profiling tools with the debugger (Diagnostic Tools window).

Команда List Memory List Memory Command

Отображает содержимое указанного диапазона памяти. Displays the contents of the specified range of memory.

Синтаксис Syntax

Аргументы Arguments

Необязательный элемент. Optional. Адрес памяти, с которого начинается отображение памяти. The memory address from which to begin displaying memory.

Коммутаторы Switches

Необязательный параметр. Optional. Отображает память в виде символов, соответствующих байтам памяти, в формате ANSI или Юникод. Display the memory as characters corresponding to the bytes of memory, either ANSI or Unicode.

/Count: number /Count: number

Необязательный параметр. Optional. Определяет, сколько байт памяти нужно отобразить, начиная с expression . Determines how many bytes of memory to display, starting at expression .

/Format: formattype /Format: formattype

Необязательный параметр. Optional. Тип формата для просмотра данных памяти в окне Память, может иметь значение OneByte, TwoBytes, FourBytes, EightBytes, Float (32-разрядный) или Double (64-разрядный). Format type for viewing memory information in the Memory window; may be OneByte, TwoBytes, FourBytes, EightBytes, Float (32-bit), or Double (64-bit). При использовании OneByte параметр /Unicode недоступен. If OneByte is used, /Unicode is unavailable.

Необязательный параметр. Optional. Указывает формат для просмотра чисел: со знаком, без знака или в шестнадцатеричном формате. Specifies the format for viewing numbers: as signed, unsigned, or hexadecimal.

Анализ использования памяти без использования отладки в Профилировщике производительности Analyze memory usage without debugging in the Performance Profiler

Средство Использование памяти отслеживает использование памяти в приложении. The Memory Usage tool monitors your app’s memory use. Вы можете использовать его для изучения воздействия сценариев, разрабатываемых в Visual Studio, на память в режиме реального времени. You can use the tool to study the real-time memory effects of scenarios you’re actively developing in Visual Studio. Можно создавать подробные моментальные снимки состояния памяти приложения и сравнивать их для выявления первопричин проблем с памятью. You can take detailed snapshots of the app’s memory states, and compare snapshots to find the root causes of memory issues. Средство использования памяти поддерживается в приложениях .NET, ASP.NET, C++ и смешанных приложениях (на основе .NET и машинного кода). The Memory Usage tool is supported on .NET, ASP.NET, C++, or mixed mode (.NET and native) apps.

Средство Использование памяти можно запускать с отладчиком или без него. The Memory Usage tool can run with or without the debugger. Из этой статьи вы узнаете, как в Профилировщике производительности Visual Studio использовать средство «Использование памяти» без отладчика (рекомендуется для сборок выпусков). In this article, we show how to use the Memory Usage tool without the debugger in the Visual Studio Performance Profiler, which is recommended for release builds.

Диагностические сеансы по использованию памяти Memory Usage diagnostic sessions

Запуск диагностического сеанса по использованию памяти: To start a Memory Usage diagnostic session:

Откройте проект в Visual Studio. Open a project in Visual Studio.

Средство использования памяти поддерживает приложения .NET, ASP.NET, C++ и смешанные приложениях (на основе .NET и машинного кода). The Memory Usage tool supports .NET, ASP.NET, C++, or mixed mode (.NET and native) apps.

В меню «Отладка» установите для решения конфигурацию Выпуск и выберите цель развертывания Локальный отладчик Windows (или Локальный компьютер). In the Debug menu, set the solution configuration to Release and select Local Windows Debugger (or Local Machine) as the deployment target.

В строке меню выберите Отладка > Профилировщик производительности. On the menu bar, choose Debug > Performance Profiler.

В разделе Доступные инструменты выберите Использование памяти и затем щелкните Запустить. Under Available Tools, select Memory Usage, and then select Start.

Контроль использования памяти Monitor memory use

При запуске диагностического сеанса запускается ваше приложение, а в окне Средства диагностики отображается график использования памяти приложением. When you start a diagnostic session, your app starts, and the Diagnostic Tools window displays a timeline graph of your app’s memory use.

График временной шкалы показывает колебания объема памяти по мере выполнения приложения. The timeline graph shows memory fluctuations as the app runs. Пики на графике обычно указывают на то, что некоторый код собирает или создает данные, а после обработки удаляет их. Spikes in the graph usually indicate that some code is collecting or creating data, and then discarding it when the processing is done. Крупные пики обозначают области, которые вы, вероятно, сможете оптимизировать. Large spikes indicate areas that you might be able to optimize. Особое внимание следует уделять использованию памяти без ее возвращения, так как это может указывать на неэффективное использование памяти и даже ее утечку. Of more concern is a rise in memory consumption that’s not returned, because it may indicate inefficient memory use or even a memory leak.

Создание моментальных снимков с состояний памяти приложения Take snapshots of app memory states

Приложение использует большое количество объектов, поэтому вам может потребоваться сосредоточить анализ на одном сценарии. An app uses a large number of objects, and you might want to concentrate your analysis on one scenario. Либо вы можете найти проблемы с памятью для дальнейшего изучения. Or, you may find memory issues to investigate. Вы можете создать моментальные снимки во время диагностического сеанса, чтобы зафиксировать использование памяти в определенный момент времени. You can take snapshots during a diagnostic session to capture memory usage at particular moments. Рекомендуется получить базовый снимок приложения до возникновения проблем с памятью, другой снимок — при первом возникновении проблемы, а также дополнительные снимки, если вы в состоянии повторить этот сценарий. It’s a good idea to get a baseline snapshot of an app before a memory issue appears, another snapshot after the first occurrence of the problem, and additional snapshots if you can repeat the scenario.

Чтобы сделать моментальные снимки, когда вы захотите зафиксировать данные о памяти, выберите Сделать снимок. To collect snapshots, select Take snapshot when you want to capture the memory data.

Закрытие диагностического сеанса Close the diagnostic session

Чтобы остановить сеанс мониторинга без создания отчета, просто закройте окно диагностики. To stop a monitoring session without creating a report, just close the diagnostic window. Чтобы создать отчет после сбора данных или создания моментальных снимков, выберите Остановить сбор данных. To generate a report when you’re done collecting or have taken snapshots, select Stop Collection.

Отчеты об использовании памяти Memory Usage reports

После остановки сбора данных инструмент Использование памяти останавливает приложение и отображает обзорную страницу Использование памяти. After you stop data collection, the Memory Usage tool stops the app and displays the Memory Usage overview page.

Моментальные снимки использования памяти Memory Usage snapshots

Числа на панелях Моментальный снимок показывают байты и объекты в памяти при создании каждого моментального снимка, а также разницу между данным и предыдущим снимками. The numbers in the Snapshot panes show the bytes and objects in memory when each snapshot was taken, and the difference between the snapshot and the previous one.

Эти числа являются ссылками, открывающими подробные представления отчетов Использование памяти в новых окнах Visual Studio. The numbers are links that open detailed Memory Usage report views in new Visual Studio windows. Подробный отчет о снимках отображает типы и экземпляры в одном моментальном снимке. A snapshot details report shows the types and instances in one snapshot. Разностный отчет по снимкам (diff) показывает сравнение типов и экземпляров на двух моментальных снимках. A snapshot difference (diff) report compares the types and instances in two snapshots.

Изображение Image	Описание Description
	Общее число байт в памяти на момент получения снимка. The total number of bytes in memory when the snapshot was taken. Выберите эту ссылку, чтобы отобразить подробный отчет о снимках с сортировкой по общему размеру экземпляров типов. Select this link to display a snapshot details report sorted by the total size of the type instances.
	Общее число объектов в памяти на момент получения снимка. The total number of objects in memory when the snapshot was taken. Выберите эту ссылку, чтобы отобразить подробный отчет о снимках с сортировкой по числу экземпляров типов. Select this link to display a snapshot details report sorted by the count of instances of the types.
	Разница между общим размером объектов в памяти для данного и предыдущего снимков. The difference between the total size of memory objects in this snapshot and the previous snapshot. Положительное число означает, что размер памяти этого снимка больше размера памяти предыдущего снимка, если же первый размер меньше второго, отображается отрицательное число. A positive number means the memory size of this snapshot is larger than the previous one, and a negative number means the size is smaller. Базовый означает, что моментальный снимок является первым в диагностическом сеансе. Baseline means a snapshot is the first in a diagnostic session. Нет различий означает, что разница равна нулю. No Difference means the difference is zero. Выберите эту ссылку, чтобы отобразить разностный отчет о снимках с сортировкой по разности общих размеров экземпляров типов. Select this link to display a snapshot diff report sorted by the difference in the total size of instances of the types.
	Разница между общим числом объектов в памяти для данного и предыдущего снимков. The difference between the total number of memory objects in this snapshot and the previous snapshot. Выберите эту ссылку, чтобы отобразить разностный отчет о снимках с сортировкой по разности общих количеств экземпляров типов. Select this link to display a snapshot diff report sorted by the difference in the total count of instances of the types.

Отчеты о снимках «Использование памяти» Memory Usage snapshot reports

Если выбрать одну из ссылок моментального снимка на обзорной странице Использование памяти, на новой странице открывается отчет о снимках. When you select one of the snapshot links in the Memory Usage overview page, a snapshot report opens in a new page.

В отчете о снимках можно развернуть записи Тип объекта, чтобы отобразить дочерние записи. In a snapshot report, you can expand Object Type entries to display child entries. В качестве имен экземпляров используются уникальные идентификаторы, создаваемые инструментом «Использование памяти». Instance names are unique IDs that are generated by the Memory Usage tool.

Если текст Тип объекта выделен голубым цветом, его можно выбрать для перехода к соответствующему объекту в исходном коде в отдельном окне. If an Object Type is blue, you can select it to navigate to the object in the source code, in a separate window.

Если вы не можете идентифицировать какие-либо типы или не понимаете, для чего они используются в коде, вероятно, что они относятся к объектам .NET, операционной системы или компилятора. Types that you can’t identify or whose involvement in your code you don’t understand are probably .NET, operating system, or compiler objects. Средство Использование памяти отображает эти объекты, если они входят в состав цепочек владения ваших объектов. The Memory Usage tool displays these objects if they’re involved in the ownership chains of your objects.

В отчете о снимках: In the snapshot report:

Дерево Управляемая куча показывает типы и экземпляры в отчете. The Managed Heap tree shows the types and instances in the report. При выборе типа или экземпляра отображаются деревья Пути к корню и Объекты, на которые указывает ссылка для выбранного элемента. Selecting a type or instance displays the Paths to Root and Referenced Objects trees for the selected item.

Дерево Пути к корню показывает цепочку объектов, ссылающихся на тип или экземпляр. The Paths to Root tree shows the chain of objects that reference a type or instance. Сборщик мусора .NET очищает память для объекта только после освобождения всех ссылок на него. The .NET garbage collector cleans up the memory for an object only when all references to it have been released.

Дерево Типы, на которые указывает ссылка или Объекты, на которые указывает ссылка показывает объекты, на которые ссылается выбранный тип или экземпляр. The Referenced Types or Referenced Objects tree shows the objects that the selected type or instance references.

Фильтры деревьев отчетов Report tree filters

Многие типы в приложениях мало интересуют разработчиков приложений. Many types in apps aren’t very interesting to app developers. Фильтры отчетов о снимках позволяют скрыть большинство таких типов в деревьях Управляемая куча и Пути к корню. The snapshot report filters can hide most of these types in the Managed Heap and Paths to Root trees.

Чтобы отфильтровать дерево по имени типа, введите имя в поле Фильтр. To filter a tree by type name, enter the name in the Filter box. Этот фильтр не учитывает регистр и распознает введенную строку в любой части имени типа. The filter isn’t case-sensitive, and it recognizes the specified string in any part of the type name.

Выберите Свернуть маленькие объекты в раскрывающемся списке Фильтр, чтобы скрыть все типы, у которых Размер (байт) меньше 0,5 процента от общего объема памяти. Select Collapse Small Objects in the Filter dropdown to hide types whose Size (Bytes) is less than 0.5 percent of the total memory.

Выберите Только мой код в раскрывающемся списке Фильтр, чтобы скрыть большинство экземпляров, созданных внешним кодом. Select Just My Code in the Filter dropdown to hide most instances that are generated by external code. Внешние типы принадлежат операционной системе или компонентам платформы либо создаются компилятором. External types belong to the operating system or framework components, or are generated by the compiler.

Подробные отчеты о снимках Snapshot details reports

Подробный отчет о снимках описывает один снимок из диагностического сеанса. A snapshot details report describes one snapshot from a diagnostic session. Чтобы открыть отчет, выберите ссылку размера или объектов в области моментального снимка. To open the report, select the size or objects link in a snapshot pane.

Обе ссылки открывают один и тот же отчет. Both links open the same report. Единственное различие заключается в начальном порядке сортировки дерева Управляемая куча. The only difference is the starting sort order of the Managed Heap tree. Ссылка размера сортирует отчет по столбцу Инклюзивный размер (байт) . The size link sorts the report by the Inclusive Size (Bytes) column. Ссылка объектов сортирует отчет по столбцу Количество. The objects link sorts the report by the Count column. Вы можете изменить порядок или столбец сортировки после открытия отчета. You can change the sort column or order after the report opens.

Дерево «Управляемая куча» (подробные отчеты о снимках) Managed Heap tree (Snapshot details reports)

Дерево Управляемая куча перечисляет типы объектов, которые хранятся в памяти. The Managed Heap tree lists the types of objects that are held in memory. Вы можете развернуть имя типа, чтобы просмотреть десять самых крупных экземпляров этого типа, отсортированных по размеру. Expand a type name to view the ten largest instances of the type, sorted by size. При выборе типа или экземпляра отображаются деревья Пути к корню и Объекты, на которые указывает ссылка для выбранного элемента. Select a type or instance to display the Paths to Root and Referenced Objects trees for the selected item.

Дерево Управляемая куча в подробном отчете о снимках содержит следующие столбцы: The Managed Heap tree in a snapshot details report has the following columns:

name Name	Описание Description
Тип объекта Object Type	Имя типа или экземпляра объекта. The name of the type or object instance.
Количество Count	Число экземпляров объекта типа. The number of object instances of the type. Для экземпляра Количество всегда равно 1. Count is always 1 for an instance.
Размер (байт) Size (Bytes)	Для типа — это размер всех экземпляров типа в снимке без учета размера объектов, содержащихся в этих экземплярах. For a type, the size of all instances of the type in the snapshot, less the size of objects contained in the instances. Для экземпляра — это размер объекта без учета размера объектов, содержащихся в экземпляре. For an instance, the size of the object, less the size of objects contained in the instance.
Инклюзивный размер (байт) Inclusive Size (Bytes)	Размер экземпляров типа или размер отдельного экземпляра, включая размер содержащихся внутри объектов. The size of the instances of the type, or the size of a single instance, including the size of contained objects.
Модуль Module	Модуль, содержащий объект. The module that contains the object.

Дерево «Пути к корню» (подробные отчеты о снимках) Paths to Root tree (Snapshot details reports)

Дерево Пути к корню показывает цепочку объектов, ссылающихся на тип или экземпляр. The Paths to Root tree shows the chain of objects that reference a type or instance. Сборщик мусора .NET очищает память для объекта только после освобождения всех ссылок на него. The .NET garbage collector cleans up the memory for an object only when all references to it have been released.

Для типа в дереве Пути к корню число объектов, которые содержат ссылки на этот тип, отображается в столбце Количество ссылок. For a type in the Paths to Root tree, the number of objects that hold references to that type appears in the Reference Count column.

Дерево «Типы, на которые указывает ссылка» или «Объекты, на которые указывает ссылка» (подробные отчеты о снимках) Referenced Types or Referenced Objects tree (Snapshot details reports)

Дерево Типы, на которые указывает ссылка или Объекты, на которые указывает ссылка показывает объекты, на которые ссылается выбранный тип или экземпляр. The Referenced Types or Referenced Objects tree shows the objects that the selected type or instance references.

Дерево Типы, на которые указывает ссылка в подробном отчете о снимках содержит следующие столбцы: A Referenced Types tree in a snapshot details report has the following columns. Дерево Объекты, на которые указывает ссылка не содержит столбец Количество ссылок. A Referenced Objects tree does not have the Reference Count column.

name Name	Описание Description
Тип объекта или Экземпляр Object Type or Instance	Имя типа или экземпляра. The name of the type or instance.
Количество ссылок Reference Count	Для типов это число экземпляров объекта типа. For types, the number of object instances of the type.
Размер (байт) Size (Bytes)	Для типа — это размер всех экземпляров типа без учета размера объектов, содержащихся в этом типе. For a type, the size of all instances of the type, less the size of objects contained in the type. Для экземпляра — это размер объекта без учета размера объектов, содержащихся в объекте. For an instance, the size of the object, less the size of objects contained in the object.
Инклюзивный размер (байт) Inclusive Size (Bytes)	Размер экземпляров типа или размер экземпляра, включая размер содержащихся внутри объектов. The total size of the instances of the type, or the size of the instance, including the size of contained objects.
Модуль Module	Модуль, содержащий объект. The module that contains the object.

Разностные отчеты по снимкам (diff) Snapshot difference (diff) reports

Разностный отчет по снимкам (diff) показывает изменения между основным и предыдущим снимками. A snapshot difference (diff) report shows the changes between a primary snapshot and the preceding snapshot. Чтобы открыть разностный отчет, выберите одну из ссылок различия в области снимка. To open a diff report, select one of the difference links in a snapshot pane.

Обе ссылки открывают один и тот же отчет. Both links open the same report. Единственное различие заключается в начальном порядке сортировки дерева Управляемая куча в этом отчете. The only difference is the starting sort order of the Managed Heap tree in the report. Ссылка размера сортирует отчет по столбцу Разница инклюзивного размера (байт) . The size link sorts the report by the Inclusive Size Diff (Bytes) column. Ссылка объектов сортирует отчет по столбцу Разница по количеству. The objects link sorts the report by the Count Diff column. Вы можете изменить порядок или столбец сортировки после открытия отчета. You can change the sort column or order after the report opens.

Дерево «Управляемая куча» (отчеты о разнице между снимками) Managed Heap tree (Snapshot diff reports)

Дерево Управляемая куча перечисляет типы объектов, которые хранятся в памяти. The Managed Heap tree lists the types of objects that are held in memory. Вы можете развернуть имя типа, чтобы просмотреть десять самых крупных экземпляров этого типа, отсортированных по размеру. You can expand a type name to view the ten largest instances of the type, sorted by size. При выборе типа или экземпляра отображаются деревья Пути к корню и Объекты, на которые указывает ссылка для выбранного элемента. Select a type or instance to display the Paths to Root and Referenced Objects trees for the selected item.

Дерево Управляемая куча в отчете о различиях снимков содержит следующие столбцы: The Managed Heap tree in a snapshot diff report has the following columns:

name Name	Описание Description
Тип объекта Object Type	Имя типа или экземпляра объекта. The name of the type or object instance.
Количество Count	Число экземпляров типа в основном снимке. The number of instances of a type in the primary snapshot. Для экземпляра Количество всегда равно 1. Count is always 1 for an instance.
Разница количества Count Diff	Для типа разница в количестве экземпляров типа между основным и предыдущим снимками. For a type, the difference in the number of instances of the type between the primary snapshot and the previous snapshot. Для экземпляра это поле отображается пустым. The field is blank for an instance.
Размер (байт) Size (Bytes)	Размер объектов в основном снимке без учета размера объектов, содержащихся в этих объектах. The size of the objects in the primary snapshot, less the size of objects in the objects. Для типа Размер (байт) и Инклюзивный размер (байт) — это общие размеры экземпляров типа. For a type, Size (Bytes) and Inclusive Size (Bytes) are the totals of the sizes of the type instances.
Разница общего размера (байт) Total Size Diff (Bytes)	Для типа — это разница в общем размере экземпляров типа между основным снимком и предыдущим снимком без учета размера объектов, содержащихся в этих экземплярах. For a type, the difference in the total size of instances of the type between the primary snapshot and the previous snapshot, less the size of objects in the instances. Для экземпляра это поле отображается пустым. The field is blank for an instance.
Инклюзивный размер (байт) Inclusive Size (Bytes)	Размер объектов в основном снимке без учета размера объектов, содержащихся в этих объектах. The size of the objects in the primary snapshot, including the size of objects in the objects.
Разница инклюзивного размера (байт) Inclusive Size Diff (Bytes)	Для типа — это разница в размере всех экземпляров типа между основным снимком и предыдущим снимком с учетом размера объектов, содержащихся в этих объектах. For a type, the difference in the size of all instances of the type between the primary snapshot and the previous snapshot, including the size of objects in the objects. Для экземпляра это поле отображается пустым. The field is blank for an instance.
Модуль Module	Модуль, содержащий объект. The module that contains the object.

Дерево «Пути к корню» (отчеты о разнице между снимками) Paths to Root tree (Snapshot diff reports)

Дерево Пути к корню показывает цепочку объектов, ссылающихся на тип или экземпляр. The Paths to Root tree shows the chain of objects that reference a type or instance. Сборщик мусора .NET очищает память для объекта только после освобождения всех ссылок на него. The .NET garbage collector cleans up the memory for an object only when all references to it have been released.

Для типа в дереве Пути к корню число объектов, которые содержат ссылки на этот тип, отображается в столбце Количество ссылок. For a type in the Paths to Root tree, the number of objects that hold references to that type appears in the Reference Count column. Разница по количеству от предыдущего снимка указана в столбце в Reference Diff (Разница по ссылкам). The difference in count from the previous snapshot is in the Reference Diff column.

Дерево «Типы, на которые указывает ссылка» или «Объекты, на которые указывает ссылка» (отчеты о различиях снимков) Referenced Types or Referenced Objects tree (Snapshot diff reports)

Дерево Типы, на которые указывает ссылка или Объекты, на которые указывает ссылка показывает объекты, на которые ссылается выбранный тип или экземпляр. The Referenced Types or Referenced Objects tree shows the objects that the selected type or instance references.

Дерево Типы, на которые указывает ссылка в отчете о различиях снимков содержит следующие столбцы: A Referenced Types tree in a snapshot diff report has the following columns. Дерево Объекты, на которые указывает ссылка имеет столбцы Экземпляр, Размер (байт) , Инклюзивный размер (байт) и Модуль. A Referenced Objects tree has the Instance, Size (Bytes), Inclusive Size (Bytes), and Module columns.