.NET 帮助

C# Sleep（开发人员如何使用）

Q: TimeSpan 重载如何增强 Thread.Sleep 的使用？

Thread.Sleep 方法的 TimeSpan 重载允许开发人员以更可读和灵活的方式指定持续时间。例如，使用 Thread.Sleep(new TimeSpan(0, 0, 5)) 会将线程暂停 5 秒钟。这在时间敏感的应用程序中很有帮助，例如在使用 IronPDF 创建 PDF 时。

Curtis Chau

已更新:七月 28, 2025

C# 中的 Thread.Sleep 方法是一个静态方法，属于 Thread 类，位于 System.Threading 命名空间内。此方法暂停当前线程的执行，持续指定的时间。这是为了让其他线程运行或在执行中引入延迟。暂停的持续时间以毫秒为单位指定，使其成为控制线程执行时机的精确工具。本教程的目的是为您提供如何在 C# 程序中使用 Sleep 方法的基础知识，并提供其实用示例以及对其行为和对程序执行影响的见解。

理解 Sleep 方法

从本质上讲，Sleep 方法使用简单。它只需一个参数：一个整数，表示需要暂停线程的时间（以毫秒为单位）。对于需要延迟的任务，该休眠函数是重要的工具，提供了一种将 CPU 时间分配给其他线程的简单方法。

这是使用 Sleep 方法的基本示例：

using System;
using System.Threading;

class Program
{
    public static void Main()
    {
        Console.WriteLine("Execution starts.");
        Thread.Sleep(2000); // Sleep for 2000 milliseconds
        Console.WriteLine("Execution resumes after 2 seconds.");
    }
}

using System;
using System.Threading;

class Program
{
    public static void Main()
    {
        Console.WriteLine("Execution starts.");
        Thread.Sleep(2000); // Sleep for 2000 milliseconds
        Console.WriteLine("Execution resumes after 2 seconds.");
    }
}

Imports System
Imports System.Threading

Friend Class Program
	Public Shared Sub Main()
		Console.WriteLine("Execution starts.")
		Thread.Sleep(2000) ' Sleep for 2000 milliseconds
		Console.WriteLine("Execution resumes after 2 seconds.")
	End Sub
End Class

$vbLabelText $csharpLabel

在上述程序中，使用主方法中的 Thread.Sleep(2000) 暂停了程序的主线程，使其执行暂停 2 秒后再继续。这演示了如何应用 Sleep 方法在执行流中引入延迟。

Sleep 方法的实际应用

Sleep 方法在各种场景中都具有实际应用，例如在 Web 开发中模拟时间消耗操作、管理 GUI 应用程序中的执行流或在控制台应用程序中创建计时器。通过暂停整个线程的执行一段指定时间，开发者可以控制执行的节奏、模拟现实世界的延迟，或通过将 CPU 时间让给其他线程或进程来管理资源消耗。

循环中的示例

设想您需要以固定间隔重复执行一段代码。 Sleep 方法可以用于在循环的每次迭代中引入必要的延迟：

for (int i = 0; i < 5; i++)
{
    Thread.Sleep(1000); // Wait for 1 second
    Console.WriteLine($"Iteration {i + 1}");
}

for (int i = 0; i < 5; i++)
{
    Thread.Sleep(1000); // Wait for 1 second
    Console.WriteLine($"Iteration {i + 1}");
}

For i As Integer = 0 To 4
	Thread.Sleep(1000) ' Wait for 1 second
	Console.WriteLine($"Iteration {i + 1}")
Next i

$vbLabelText $csharpLabel

在上述示例中，循环执行五次，每次迭代之间暂停 1 秒。这一技术常用于诸如数据轮询等需要请求间有延迟的任务中。

高级用法：TimeSpan 重载

Thread.Sleep 方法还提供了一种重载，可接受 TimeSpan 对象而不是整数。这使得开发人员能够以更为易读和灵活的方式指定休眠时间，尤其是在处理几秒以上的时长或延迟是动态计算时。

TimeSpan timeout = new TimeSpan(0, 0, 5); // 5 seconds
Thread.Sleep(timeout);

TimeSpan timeout = new TimeSpan(0, 0, 5); // 5 seconds
Thread.Sleep(timeout);

Dim timeout As New TimeSpan(0, 0, 5) ' 5 seconds
Thread.Sleep(timeout)

$vbLabelText $csharpLabel

此示例创建了一个表示 5 秒的 TimeSpan 实例，并将其传递给 Thread.Sleep。这种指定延迟持续时间的方法可以提高代码的可读性和维护性。

注意事项和最佳实践

虽然 Sleep 方法是控制线程执行的强大工具，但重要的是要谨慎使用它。休眠一个线程会阻塞其执行，这可能导致效率低下或响应迟钝，特别是在响应速度非常关键的 UI 应用程序或服务中。始终要考虑替代方法，如异步编程或使用计时器，可以提供更多的灵活性和效率来管理延迟或在不阻塞线程的情况下调度任务。

IronPDF库简介

C# 睡眠（对开发人员的工作原理）：图 1 - IronPDF 网页

IronPDF 是一个为 .NET 环境设计的 PDF 库，使用 C# 使开发人员能够从 HTML、CSS、JavaScript 和图像生成 PDF 文件。 IronPDF 脱颖而出，因为它简化了创建 PDF 的过程，消除了对不同 API 的需求。取而代之的是，它利用内置、符合标准的网络浏览器的功能直接将 HTML 内容呈现成 PDF 格式。

IronPDF 支持各种应用程序，包括 Web、服务器和桌面平台，完全兼容主要操作系统环境，如 Windows、Linux 和 macOS。它提供诸如编辑 PDF 属性和安全性、添加数字签名，以及从 PDF 文档中提取文本和图像等功能。

代码示例

让我们创建一个简单的 C# 代码示例，使用 IronPDF 从 HTML 内容生成 PDF 文档，包括在 PDF 生成过程前的延迟（休眠）。此示例假设您已通过 NuGet 在项目中安装 IronPDF 包。 System.Threading 命名空间提供了 Thread.Sleep 方法，我们可以用来引入延迟。在某些需要等待特定条件满足后再生成 PDF 的场景下（例如等待外部来源的数据），这可能派上用场。

using System;
using IronPdf;
using System.Threading;

class Program
{
    static void Main(string[] args)
    {
        // Assign a license key
        License.LicenseKey = "License-Key";

        // Create a new instance of ChromePdfRenderer
        var renderer = new ChromePdfRenderer();
        Console.WriteLine("Waiting for 5 seconds before generating PDF...");

        // Sleep for 5 seconds (5000 milliseconds)
        Thread.Sleep(5000);

        // Generate a PDF from HTML string
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello, World!</h1><p>This is a PDF generated after a delay.</p>");

        // Save the PDF to a file
        string filePath = "HelloWorld.pdf";
        pdf.SaveAs(filePath);
        Console.WriteLine($"PDF generated and saved to {filePath}");
    }
}

using System;
using IronPdf;
using System.Threading;

class Program
{
    static void Main(string[] args)
    {
        // Assign a license key
        License.LicenseKey = "License-Key";

        // Create a new instance of ChromePdfRenderer
        var renderer = new ChromePdfRenderer();
        Console.WriteLine("Waiting for 5 seconds before generating PDF...");

        // Sleep for 5 seconds (5000 milliseconds)
        Thread.Sleep(5000);

        // Generate a PDF from HTML string
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello, World!</h1><p>This is a PDF generated after a delay.</p>");

        // Save the PDF to a file
        string filePath = "HelloWorld.pdf";
        pdf.SaveAs(filePath);
        Console.WriteLine($"PDF generated and saved to {filePath}");
    }
}

Imports System
Imports IronPdf
Imports System.Threading

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		' Assign a license key
		License.LicenseKey = "License-Key"

		' Create a new instance of ChromePdfRenderer
		Dim renderer = New ChromePdfRenderer()
		Console.WriteLine("Waiting for 5 seconds before generating PDF...")

		' Sleep for 5 seconds (5000 milliseconds)
		Thread.Sleep(5000)

		' Generate a PDF from HTML string
		Dim pdf = renderer.RenderHtmlAsPdf("<h1>Hello, World!</h1><p>This is a PDF generated after a delay.</p>")

		' Save the PDF to a file
		Dim filePath As String = "HelloWorld.pdf"
		pdf.SaveAs(filePath)
		Console.WriteLine($"PDF generated and saved to {filePath}")
	End Sub
End Class

$vbLabelText $csharpLabel

以下示例执行以下操作：

导入必要的命名空间。
创建来自 IronPDF 库的 ChromePdfRenderer 类的实例。
使用 Thread.Sleep(5000) 创建一个 5 秒的延迟，然后生成 PDF。
使用 RenderHtmlAsPdf 方法将 HTML 字符串转换为 PDF 文档。
将生成的 PDF 保存为名为 HelloWorld.pdf 的文件

C# 睡眠（对开发人员的工作原理）：图 2 - 从上述代码输出的 PDF

请确保根据您的具体要求调整 HTML 内容和文件路径。

结论

C# 睡眠（对开发人员的工作原理）：图 3 - IronPDF 许可页面

Thread.Sleep 方法是 C# 中用于在线程执行中引入延迟的一个简单而强大的工具。无论您是在开发控制台应用程序、从事 Web 开发项目，还是创建 GUI 应用程序，理解如何有效使用 Thread.Sleep 都是至关重要的。通过控制执行流程、模拟操作或管理资源，该方法为开发人员提供了一种简单机制以满足各种编程需求。请记得明智地使用它，考虑其对应用程序性能和响应的影响。

随着您继续提升 C# 编程技能，尝试使用 Sleep 方法和其他线程功能可以增强您创建高效、响应快速应用程序的能力。最后，值得一提的是，IronPDF 提供试用许可证供开发人员探索其功能，许可证起价为 $799。