.NET幫助

C# Using 語句（對於開發者的運行原理）

Curtis Chau

更新日期:7月 28, 2025

C#中的using语句是一个基本概念，有助于高效地管理资源，尤其是在处理可释放对象时。本教程将详细解析using语句是什么，它如何工作，为什么它是有益的，尤其是对于C#的新手。

到本指南结束时，您将对如何在代码中实现此语句以实现更好的资源管理以及编写更简洁、可读性更高的代码有一个坚实的理解。我们还将在本文后面讨论如何结合using语句集成IronPDF。

了解可释放对象和IDisposable接口

在深入研究using语句之前，了解可释放对象和IDisposable接口是至关重要的。在.NET中，许多资源如文件句柄、网络连接和数据库连接并不由垃圾收集器管理。

此类资源被称为非托管资源。为了正确管理这些资源，封装它们的类实现了IDisposable接口，其中包括一个方法Dispose。当不再需要时调用此方法以手动释放非托管资源。

Using语句的基础

语法和用法

using语句简化了释放非托管资源的过程。它确保在对象超出作用域时立即调用Dispose方法。

可以将using块看作一个安全区域，确保使用后资源被自动清理。这是一个用于说明其用法的基本示例：

using (StreamReader reader = new StreamReader("file.txt"))
{
    // You can read the file here
    // When the block is exited, the StreamReader's Dispose method is automatically called.
}

using (StreamReader reader = new StreamReader("file.txt"))
{
    // You can read the file here
    // When the block is exited, the StreamReader's Dispose method is automatically called.
}

Using reader As New StreamReader("file.txt")
	' You can read the file here
	' When the block is exited, the StreamReader's Dispose method is automatically called.
End Using

$vbLabelText $csharpLabel

在上面的例子中，StreamReader是一个实现了IDisposable接口的类。 using语句确保reader的Dispose方法在控制权离开由大括号定义的范围时自动调用。

工作原理

当您用using语句包装一个可释放对象时，它本质上被转换为一个try块与finally块。在finally块中调用Dispose方法，确保即使发生异常也能正确释放资源。

如果using块中的代码抛出错误，不必担心； Dispose方法仍将被调用，确保资源以安全方式释放。

Using语句的高级概念

管理多个资源

您可以在一个using语句中管理多个可释放对象。这种方法使您的代码保持简洁并确保所有资源都被正确释放：

using (SqlConnection conn = new SqlConnection(connString))
using (SqlCommand cmd = new SqlCommand(query, conn))
{
    // Work with your database here
    // Both conn and cmd will be disposed of when the block is exited.
}

using (SqlConnection conn = new SqlConnection(connString))
using (SqlCommand cmd = new SqlCommand(query, conn))
{
    // Work with your database here
    // Both conn and cmd will be disposed of when the block is exited.
}

Using conn As New SqlConnection(connString)
Using cmd As New SqlCommand(query, conn)
	' Work with your database here
	' Both conn and cmd will be disposed of when the block is exited.
End Using
End Using

$vbLabelText $csharpLabel

使用别名指令

除了using语句的核心功能外，C#还提供了如using alias directive和在using块中高效处理局部变量等功能，以进一步简化资源管理并增强代码可读性。

有时，在使用外部库或处理类名冲突时，我们的代码可能会变得混乱且难以理解。 using alias directive通过允许我们给命名空间或类分配一个更具可读性或更短的别名来拯救我们。

我们来考虑一个场景，您正在处理两个具有相同名称但位于不同命名空间中的类。您可以使用using别名指令轻松地区分它们：

using Project = FirstNamespace.Project;
using ExternalProject = SecondNamespace.Project;

// Now you can use Project and ExternalProject in your code to refer to the specific classes without confusion.

using Project = FirstNamespace.Project;
using ExternalProject = SecondNamespace.Project;

// Now you can use Project and ExternalProject in your code to refer to the specific classes without confusion.

Imports Project = FirstNamespace.Project
Imports ExternalProject = SecondNamespace.Project

' Now you can use Project and ExternalProject in your code to refer to the specific classes without confusion.

$vbLabelText $csharpLabel

Using声明

在C# 8.0中引入的using声明是语法糖，使您的代码更加简洁。无需用大括号包装可释放对象，您可以声明它，它将在其声明范围结束时被释放：

using StreamReader reader = new StreamReader("file.txt");
// Use reader here
// It will be disposed of here automatically at the end of the scope.

using StreamReader reader = new StreamReader("file.txt");
// Use reader here
// It will be disposed of here automatically at the end of the scope.

Using reader As New StreamReader("file.txt")
	' Use reader here
	' It will be disposed of here automatically at the end of the scope.
End Using

$vbLabelText $csharpLabel

自定义类和IDisposable

通过实现IDisposable接口，您可以将using语句应用于自定义类。当您的类负责管理一个或多个资源时，这尤其有用：

public class ResourceHolder : IDisposable
{
    public void Dispose()
    {
        // Code to release your resources here
    }
}

public class ResourceHolder : IDisposable
{
    public void Dispose()
    {
        // Code to release your resources here
    }
}

Public Class ResourceHolder
	Implements IDisposable

	Public Sub Dispose() Implements IDisposable.Dispose
		' Code to release your resources here
	End Sub
End Class

$vbLabelText $csharpLabel

当您的类实现了IDisposable后，您可以像使用其他可释放对象一样在using语句中使用它。

介绍IronPDF：C# PDF库

C# Using语句（它对开发者的作用）：图1

IronPDF for .NET PDF生成是一个为.NET平台设计的综合PDF生成库，其核心由C#构建。 IronPDF通过利用HTML、CSS、图像和JavaScript来实现高效的PDF渲染，PDF创建过程变得简单易行。

它支持综合的PDF操作，使通常通过其他API进行的复杂任务变得简化。不仅简化了PDF创建过程，还提高了在包括网络、服务器、控制台和桌面应用程序在内的广泛应用程序类型中的兼容性。

IronPDF非常适合将网页、URL和HTML转换为PDF，看起来就像原始版本。它非常适合用于生成在线内容的PDF，例如报表和发票。需要网页的PDF文件吗？ IronPDF为您提供辅助！

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

Imports IronPdf

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim renderer = New ChromePdfRenderer()

		' 1. Convert HTML String to PDF
		Dim htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>"
		Dim pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent)
		pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf")

		' 2. Convert HTML File to PDF
		Dim htmlFilePath = "path_to_your_html_file.html" ' Specify the path to your HTML file
		Dim pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath)
		pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf")

		' 3. Convert URL to PDF
		Dim url = "http://ironpdf.com" ' Specify the URL
		Dim pdfFromUrl = renderer.RenderUrlAsPdf(url)
		pdfFromUrl.SaveAs("URLToPDF.pdf")
	End Sub
End Class

$vbLabelText $csharpLabel

安裝 IronPDF

向您的项目中添加IronPDF的最有效方式是通过NuGet软件包管理器。只需打开Visual Studio中的项目，导航到"解决方案资源管理器"，右键单击"依赖项"，然后选择"管理NuGet软件包"。在这里，您可以搜索"IronPdf"并通过几个点击安装该软件包。

C# Using语句（它对开发者的作用）：图2

IronPDF与Using语句的示例用法

让我们回到C#中用于资源管理的using语句。以下是一个简单的代码示例，展示如何使用IronPDF从HTML内容生成PDF，并使用using语句确保正确处理资源：

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // Generate a PDF from HTML string and save it
        using (var document = renderer.RenderHtmlAsPdf("<h1>Hello, IronPDF!</h1>"))
        {
            document.SaveAs("HelloIronPDF.pdf");
        }
        // The using statement ensures that resources are cleaned up correctly
    }
}

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // Generate a PDF from HTML string and save it
        using (var document = renderer.RenderHtmlAsPdf("<h1>Hello, IronPDF!</h1>"))
        {
            document.SaveAs("HelloIronPDF.pdf");
        }
        // The using statement ensures that resources are cleaned up correctly
    }
}

Imports IronPdf

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim renderer = New ChromePdfRenderer()

		' Generate a PDF from HTML string and save it
		Using document = renderer.RenderHtmlAsPdf("<h1>Hello, IronPDF!</h1>")
			document.SaveAs("HelloIronPDF.pdf")
		End Using
		' The using statement ensures that resources are cleaned up correctly
	End Sub
End Class

$vbLabelText $csharpLabel

C# Using语句（它对开发者的作用）：图3