C#内存转储，或称为dump文件，是应用程序在特定时刻状态的快照。它们对于诊断问题（如性能问题、崩溃和内存泄漏）非常有帮助。本文将向您介绍什么是内存转储，如何生成它们，以及如何分析它们。
1.什么是内存转储？
内存转储实质上是一个应用程序在特定点状态的快照。它包含了与应用程序相关的系统内存中的所有内容，包括变量、线程和堆栈跟踪。当进行调试，特别是尝试复制难以重现的错误时，这些数据可能会非常有用。
2.在 C# 中生成内存转储
有多种方式可以为 .NET 应用程序生成内存转储。一种常见的方法是使用任务管理器或 Process Explorer。另一种方式是使用像 DebugDiag 这样的工具或 CLRMD 这样的库来以编程方式实现。
使用任务管理器或Process Explorer：
运行你的应用程序。 打开任务管理器并转到 进程 选项卡。 右键点击你的进程并选择 "创建转储文件"。 几分钟之后，弹出窗口将显示转储文件的位置。
使用 DebugDiag：
从 Microsoft 的网站下载并安装 Debug Diagnostic Tool 2 Update 2 ( DebugDiag) 。运行该工具并点击 "添加规则" 按钮。 选择适合你需要的规则类型（例如，崩溃，性能，或手动）。 选择你想要监控的进程。 设置规则的具体内容（如收集的转储数量），然后激活它。
分析内存转储
分析内存转储需要专门的工具，最常用的是 Visual Studio 和 WinDbg。
使用 Visual Studio：
打开 Visual Studio。 转到 文件 > 打开 > 项目/解决方案。 导航到你的 .dmp文件并打开它。Visual Studio 将自动分析崩溃转储并突出显示重要信息。
使用 WinDbg：
WinDbg 是一个更高级的工具，但它允许对内存转储进行深度分析：
下载并安装包含 WinDbg 的 Windows 调试工具。 打开 WinDbg，并加载你的转储文件（ 文件 > 打开崩溃转储）。加载调试 .NET 应用程序所需的扩展，如 SOS ( !loadby sos clr)。使用各种命令来分析转储（例如，使用 !clrstack来查看管理堆栈）。
3.代码使用示例
Dump在.NET Framework版本中应用
using System;
using System.IO;
using System.Runtime.InteropServices;
using System.Diagnostics;
public class Program
{
[Flags]
public enum Option : uint
{
// These options are omitted for brevity, see MSDN for more details.
MiniDumpWithFullMemory = 0x00000002,
MiniDumpWithHandleData = 0x00000004
}
[StructLayout(LayoutKind.Sequential, Pack = 4)]
public struct MiniDumpExceptionInformation
{
public uint ThreadId;
public IntPtr ExceptionPointers;
[MarshalAs(UnmanagedType.Bool)]
public bool ClientPointers;
}
[DllImport("dbghelp.dll", SetLastError = true)]
public static extern bool MiniDumpWriteDump(IntPtr hProcess,
uint processId,
SafeHandle hFile,
uint dumpType,
ref MiniDumpExceptionInformation expParam,
IntPtr userStreamParam,
IntPtr callbackParam);
public static void Main()
{
CreateDump();
}
public static void CreateDump()
{
// Get the current running process.
Process currentProcess = Process.GetCurrentProcess();
// Create an ExceptionInformation object
MiniDumpExceptionInformation eInfo = new MiniDumpExceptionInformation();
eInfo.ThreadId = (uint)currentProcess.Threads[0].Id;
eInfo.ExceptionPointers = Marshal.GetExceptionPointers();
eInfo.ClientPointers = false;
string filePath = @"C:\temp\dumpfile.dmp";
using (FileStream stream = new FileStream(filePath, FileMode.Create))
{
bool success = MiniDumpWriteDump(currentProcess.Handle, (uint)currentProcess.Id, stream.SafeFileHandle, (uint)Option.MiniDumpWithFullMemory, ref eInfo, IntPtr.Zero, IntPtr.Zero);
if (!success)
{
throw new Exception("MiniDumpWriteDump failed");
}
}
}
}
Dump在.NET Core之后的版本中应用
在 .NET Core 中，由于它是跨平台的，你无法直接使用 MiniDumpWriteDump 这个 Windows API 函数。但你可以使用一些第三方库来实现这个功能。
首先，需要在项目中安装 Microsoft.Diagnostics.NETCore.Client 库。你可以通过 NuGet 包管理器或者以下命令进行安装：
dotnet add package Microsoft.Diagnostics.NETCore.Client
代码：
using Microsoft.Diagnostics.NETCore.Client;
namespace DumpDemo
{
internal class Program
{
static void Main(string[] args)
{
int processId = int.Parse(args[0]); // The process ID to collect the dump from
string dumpFilePath = args[1]; // The path where the dump file should be written
CreateDump(processId, dumpFilePath);
}
public static void CreateDump(int processId, string dumpFilePath)
{
var client = new DiagnosticsClient(processId);
// Dumper.CollectDump(Process process, string dumpFileName, DumpTypeOption type)
client.WriteDump(DumpType.Normal, dumpFilePath);
}
}
}
DumpType枚举：
public enum DumpType
{
Normal = 1,
WithHeap = 2,
Triage = 3,
Full = 4
}
各个枚举值的含义如下：
Normal：主要包含线程和某些系统信息，但不包括堆信息。此类型的 dump 文件较小，适用于在处理能力有限的环境中快速捕获应用程序的状态。 WithHeap：包含 Normal 类型的所有信息，还额外包含所有托管堆内存的信息。此类型的 dump 文件可以用于进行更详细的分析，例如内存泄漏分析。 Triage：包含一些关键线程和模块数据，以及与异常相关的对象。此类型的 dump 文件主要用于快速诊断常见问题。 Full：包含进程的所有内存，包括所有线程、堆和非堆内存。此类型的 dump 文件最大，可以用于进行全面的分析。
这段代码将会生成一个包含当前进程内存转储的 .dmp 文件。请确保目标文件夹有写入权限。
