.NET 帮助

Dottrace .NET Core（它是如何为开发人员工作的）

乔尔迪·巴尔迪亚

2024年七月1日

介绍 "Dottrace .NET Core"，它是 .NET 生态系统中的一个强大工具，是进行性能剖析必不可少的".NET "工具。作为".NET "性能剖析器，.NET 跟踪工具使开发人员能够捕获详细的跟踪文件，从而深入了解运行进程的运行时事件。该工具是优化基于 .NET Framework 构建的应用程序不可或缺的工具。

无论是进行单元测试还是集成持续集成构建，Dottrace 都能让您有效地监控和分析应用程序的性能。通过利用这一工具，您可以更深入地了解应用程序的行为，从而确保最高性能和可靠性。

IronPDF 是在 .NET 应用程序中处理 PDF 的综合库。它允许您创建、编辑和提取 PDF 文件中的内容。 IronPDF 支持 HTML 到 PDF 的转换、PDF 合并和分割等功能。对于任何需要生成或处理 PDF 文档的应用程序来说，该库都是一个非常有价值的工具。本文将结合 Dottrace 使用该库，表达 Dottrace 和 IronPDF 的实际应用效果。

Dottrace .NET Core 入门

在 .NET 项目中设置 Dottrace .NET Core

首先，您需要使用 NuGet 安装 Dottrace .NET Core。打开 Visual Studio 并按照以下步骤操作：

打开 Visual Studio。
选择 创建新项目。
选择 控制台应用程序(.NET Core) 然后点击下一步。
将您的项目命名为 "DottraceExample"，然后单击创建。
在解决方案资源管理器中，右键单击项目并选择管理 NuGet 包。
在 NuGet 软件包管理器中，搜索 JetBrains.dotTrace.CommandLineTools。
选择软件包并点击安装。
这会将 Dottrace 作为依赖项安装到您的项目中。

剖析一个简单的控制台应用程序

让我们创建一个基本的控制台应用程序来进行剖析。用以下代码替换 Program.cs 中的代码：

using System;
using System.Threading;
class Program
{
    static void Main(string[] args)
    {
        Console.WriteLine("Starting application...");
        Thread.Sleep(5000); // Simulating a time-consuming operation
        Console.WriteLine("Application finished.");
    }
}

using System;
using System.Threading;
class Program
{
    static void Main(string[] args)
    {
        Console.WriteLine("Starting application...");
        Thread.Sleep(5000); // Simulating a time-consuming operation
        Console.WriteLine("Application finished.");
    }
}

Imports System
Imports System.Threading
Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Console.WriteLine("Starting application...")
		Thread.Sleep(5000) ' Simulating a time-consuming operation
		Console.WriteLine("Application finished.")
	End Sub
End Class

按F5键构建并运行您的应用程序。一旦应用程序开始运行，您将需要其进程 ID 进行剖析。您可以使用 Visual Studio 的诊断工具窗口或通过检查任务管理器找到进程 ID。

要使用 Dottrace 对应用程序进行剖析，请在 Visual Studio 中打开终端窗口或软件包管理器控制台并运行：

dotnet trace collect --process-id <your-process-id> --output trace.nettrace

用您正在运行的应用程序的实际进程 ID 替换""。

应用程序完成后，您将得到一个 trace.nettrace 文件。该文件包含在应用程序执行期间收集的所有剖析数据。您可以在 Visual Studio 中分析该文件。遵循以下步骤：

打开 Visual Studio。
转到 文件 > 打开 > 文件。
选择 trace.nettrace 文件并单击打开。
Visual Studio 将显示详细的性能数据，使您能够识别并修复性能瓶颈。
现在，您已经设置了 Dottrace 并创建了一个基本的剖析示例，可以继续实施更高级的功能。

Dottrace .NET Core 的实施功能

分析 CPU 使用情况

Dottrace .NET Core 的主要功能之一是分析 CPU 使用率。这可以帮助您确定代码中哪些部分消耗的 CPU 资源最多。操作方法如下：

首先，在 Visual Studio 中启动您的应用程序。然后，在终端或软件包管理器控制台，运行

dotnet trace collect --process-id <your-process-id> --output cpu_usage.nettrace

用您应用程序的实际进程 ID 替换""。剖析会话完成后，在 Visual Studio 中打开 cpu_usage.nettrace 文件：

using System;
using System.Diagnostics;
class Program
{
    static void Main(string[] args)
    {
        var sw = new Stopwatch();
        sw.Start();
        // Simulate a CPU-intensive operation
        for (int i = 0; i < 1000000000; i++) { }
        sw.Stop();
        Console.WriteLine($"Elapsed Time: {sw.ElapsedMilliseconds} ms");
    }
}

using System;
using System.Diagnostics;
class Program
{
    static void Main(string[] args)
    {
        var sw = new Stopwatch();
        sw.Start();
        // Simulate a CPU-intensive operation
        for (int i = 0; i < 1000000000; i++) { }
        sw.Stop();
        Console.WriteLine($"Elapsed Time: {sw.ElapsedMilliseconds} ms");
    }
}

Imports System
Imports System.Diagnostics
Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim sw = New Stopwatch()
		sw.Start()
		' Simulate a CPU-intensive operation
		For i As Integer = 0 To 999999999
		Next i
		sw.Stop()
		Console.WriteLine($"Elapsed Time: {sw.ElapsedMilliseconds} ms")
	End Sub
End Class

该代码模拟了 CPU 密集型操作。当您分析 cpu_usage.nettrace 文件时，您会发现循环占用了大量的 CPU 时间。

监控内存分配

Dottrace .NET Core 还可以帮助您监控应用程序中的内存分配。这对于识别内存泄漏和优化内存使用至关重要。

运行您的应用程序并收集内存分配数据：

dotnet trace collect --process-id <your-process-id> --output memory_allocation.nettrace

会话结束后，在 Visual Studio 中打开memory_allocation.nettrace文件：

using System;
class Program
{
    static void Main(string[] args)
    {
        for (int i = 0; i < 10000; i++)
        {
            var data = new byte[1024]; // Allocate 1KB
        }
        Console.WriteLine("Memory allocation completed.");
    }
}

using System;
class Program
{
    static void Main(string[] args)
    {
        for (int i = 0; i < 10000; i++)
        {
            var data = new byte[1024]; // Allocate 1KB
        }
        Console.WriteLine("Memory allocation completed.");
    }
}

Imports System
Friend Class Program
	Shared Sub Main(ByVal args() As String)
		For i As Integer = 0 To 9999
			Dim data = New Byte(1023){} ' Allocate 1KB
		Next i
		Console.WriteLine("Memory allocation completed.")
	End Sub
End Class

这段代码在循环中分配内存。分析 memory_allocation.nettrace 文件将显示分配了多少内存，以及在代码中的哪个位置发生了分配。

剖析 I/O 操作

剖析 I/O 操作是另一项基本功能。它可以帮助您了解文件读取和写入对性能的影响。

启动应用程序并收集 I/O 数据：

dotnet trace collect --process-id <your-process-id> --output io_operations.nettrace

在 Visual Studio 中打开 io_operations.nettrace 文件进行分析：

using System;
using System.IO;
class Program
{
    static void Main(string[] args)
    {
        var filePath = "test.txt";
        // Write to file
        using (var writer = new StreamWriter(filePath))
        {
            for (int i = 0; i < 1000; i++)
            {
                writer.WriteLine("This is a test line.");
            }
        }
        // Read from file
        using (var reader = new StreamReader(filePath))
        {
            while (reader.ReadLine() != null) { }
        }
        Console.WriteLine("I/O operations completed.");
    }
}

using System;
using System.IO;
class Program
{
    static void Main(string[] args)
    {
        var filePath = "test.txt";
        // Write to file
        using (var writer = new StreamWriter(filePath))
        {
            for (int i = 0; i < 1000; i++)
            {
                writer.WriteLine("This is a test line.");
            }
        }
        // Read from file
        using (var reader = new StreamReader(filePath))
        {
            while (reader.ReadLine() != null) { }
        }
        Console.WriteLine("I/O operations completed.");
    }
}

Imports System
Imports System.IO
Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim filePath = "test.txt"
		' Write to file
		Using writer = New StreamWriter(filePath)
			For i As Integer = 0 To 999
				writer.WriteLine("This is a test line.")
			Next i
		End Using
		' Read from file
		Using reader = New StreamReader(filePath)
			Do While reader.ReadLine() IsNot Nothing
			Loop
		End Using
		Console.WriteLine("I/O operations completed.")
	End Sub
End Class

这段代码对文件进行写入和读取。分析 io_operations.nettrace 文件将显示 I/O 操作花费的时间。

识别性能瓶颈

识别性能瓶颈是使用 Dottrace 的主要目的之一。通过分析收集到的跟踪文件，您可以找出代码中运行缓慢的部分。

启动应用程序并收集性能数据：

dotnet trace collect --process-id <your-process-id> --output performance_bottlenecks.nettrace

在 Visual Studio 中打开performance_bottlenecks.nettrace文件：

using System;
using System.Threading;
class Program
{
    static void Main(string[] args)
    {
        Console.WriteLine("Starting application...");
        // Simulate a time-consuming operation
        Thread.Sleep(5000);
        Console.WriteLine("Application finished.");
    }
}

using System;
using System.Threading;
class Program
{
    static void Main(string[] args)
    {
        Console.WriteLine("Starting application...");
        // Simulate a time-consuming operation
        Thread.Sleep(5000);
        Console.WriteLine("Application finished.");
    }
}

Imports System
Imports System.Threading
Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Console.WriteLine("Starting application...")
		' Simulate a time-consuming operation
		Thread.Sleep(5000)
		Console.WriteLine("Application finished.")
	End Sub
End Class

该代码模拟了应用程序中的延迟。分析 "performance_bottlenecks.nettrace "文件将显示花费时间最多的部分，从而帮助您优化这些部分。

这些示例涵盖了 Dottrace .NET Core 的主要功能。现在，您可以在生产环境中分析 CPU 使用率、监控内存分配、剖析 I/O 操作、识别性能瓶颈并进行剖析。每项功能都能帮助您优化和改进您的 .NET Core 应用程序。

将 Dottrace 与 IronPDF 集成

IronPDF 简介

Dottrace .NET Core（如何为开发人员工作）：图 2 - IronPDF 网页

IronPDF for .NET "是一个功能强大的".NET "库，可让您在 C# 应用程序中轻松生成、编辑和管理 PDF。无论您是需要从头开始创建新的 PDF、将 HTML 转换为 PDF 还是操作现有的 PDF，IronPDF 都能提供丰富的功能来高效地完成这些任务。这对需要生成和处理 PDF 的应用程序（如报告系统、文档管理解决方案和网络应用程序）大有裨益。

IronPDF 与 Dottrace 合并的使用案例

假设您有一个为用户生成 PDF 报告的网络应用程序。通过使用 Dottrace，您可以跟踪 PDF 生成过程的性能，使用跟踪文件识别性能问题，并进行改进以增强用户体验。这种集成对于处理大量 PDF 文档或需要高性能处理的应用程序尤为重要。

使用案例的代码示例

下面是一个完整的代码示例，演示了如何将 IronPDF 与 Dottrace 集成。本示例创建了一个简单的 HTML 到 PDF 的转换，并使用 Dottrace 监控操作的性能。

using System;
using IronPdf;
using Microsoft.Diagnostics.Tracing;
using Microsoft.Diagnostics.Tracing.Session;
class Program
{
    static void Main(string[] args)
    {
        // Start tracing session
        using (var session = new TraceEventSession("MySession"))
        {
            session.EnableProvider("Microsoft-Windows-DotNETRuntime");
            // Perform PDF generation
            var pdfDocument = GeneratePdf("Hello, world!");
            // Save the PDF to a file
            pdfDocument.SaveAs("example.pdf");
            // Stop tracing session
            session.Stop();
        }
        Console.WriteLine("PDF generated and performance traced successfully.");
    }
    static PdfDocument GeneratePdf(string htmlContent)
    {
        // Create an instance of the HtmlToPdf renderer
        var renderer = new ChromePdfRenderer();
        // Convert HTML to PDF
        var pdfDocument = renderer.RenderHtmlAsPdf(htmlContent);
        return pdfDocument;
    }
}

using System;
using IronPdf;
using Microsoft.Diagnostics.Tracing;
using Microsoft.Diagnostics.Tracing.Session;
class Program
{
    static void Main(string[] args)
    {
        // Start tracing session
        using (var session = new TraceEventSession("MySession"))
        {
            session.EnableProvider("Microsoft-Windows-DotNETRuntime");
            // Perform PDF generation
            var pdfDocument = GeneratePdf("Hello, world!");
            // Save the PDF to a file
            pdfDocument.SaveAs("example.pdf");
            // Stop tracing session
            session.Stop();
        }
        Console.WriteLine("PDF generated and performance traced successfully.");
    }
    static PdfDocument GeneratePdf(string htmlContent)
    {
        // Create an instance of the HtmlToPdf renderer
        var renderer = new ChromePdfRenderer();
        // Convert HTML to PDF
        var pdfDocument = renderer.RenderHtmlAsPdf(htmlContent);
        return pdfDocument;
    }
}

Imports System
Imports IronPdf
Imports Microsoft.Diagnostics.Tracing
Imports Microsoft.Diagnostics.Tracing.Session
Friend Class Program
	Shared Sub Main(ByVal args() As String)
		' Start tracing session
		Using session = New TraceEventSession("MySession")
			session.EnableProvider("Microsoft-Windows-DotNETRuntime")
			' Perform PDF generation
			Dim pdfDocument = GeneratePdf("Hello, world!")
			' Save the PDF to a file
			pdfDocument.SaveAs("example.pdf")
			' Stop tracing session
			session.Stop()
		End Using
		Console.WriteLine("PDF generated and performance traced successfully.")
	End Sub
	Private Shared Function GeneratePdf(ByVal htmlContent As String) As PdfDocument
		' Create an instance of the HtmlToPdf renderer
		Dim renderer = New ChromePdfRenderer()
		' Convert HTML to PDF
		Dim pdfDocument = renderer.RenderHtmlAsPdf(htmlContent)
		Return pdfDocument
	End Function
End Class

Dottrace .NET Core（如何为开发人员工作）：图 3 - 前一个代码示例的控制台输出

在本示例中，我们首先创建一个 TraceEventSession 以使用 Dottrace 捕捉性能数据。然后，我们使用 IronPDF 将简单的 HTML 字符串生成 PDF。保存 PDF 后，我们将停止跟踪会话。

Dottrace .NET Core（如何为开发人员工作）：图 4 - 上一代码示例输出的 PDF

这使我们能够监控 PDF 生成过程的性能，并收集对其执行的宝贵见解。

结论

探索IronPDF 许可选项请访问页面了解可用许可证及其各自的价格。

通过将 Dottrace 与 IronPdf 集成，您可以显著提高 PDF 生成流程的性能和可靠性。这种集成可以让您深入了解应用程序如何处理 PDF 任务，帮助您优化操作并确保流畅的用户体验。 IronPDF 为处理 PDF 提供了一套全面的功能，是所有 .NET 开发人员的必备工具。

IronPDF 提供免费试用，许可证起价为 $749，让您能够在购买前评估其功能。结合 Dottrace 和 IronPdf 的强大功能，可以帮助您创建高性能、高效率的应用程序，满足用户的需求。

乔尔迪·巴尔迪亚

立即与工程团队聊天

软件工程师

Jordi 最擅长 Python、C# 和 C++，当他不在 Iron Software 运用技能时，他会进行游戏编程。作为产品测试、产品开发和研究的负责人之一，Jordi 为持续的产品改进增添了极大的价值。多样化的经验让他充满挑战和参与感，他说这是他在 Iron Software 工作中最喜欢的方面之一。Jordi 在佛罗里达州迈阿密长大，并在佛罗里达大学学习计算机科学和统计学。

< 前一页
Supersocket C# 示例（它如何为开发者工作）

下一步 >
Deedle C#（开发人员如何使用它）