.NET 帮助

C# Using语句（开发人员如何使用）

Curtis Chau

已更新:七月 28, 2025

C#中的using语句是一个基本概念，有助于高效管理资源，特别是在处理可释放的对象时。本教程将详细介绍using语句的意义、工作原理以及其好处，特别适合C#初学者。

通过本指南，您将对如何在代码中实现该语句以更好地管理资源以及编写更简洁、可读的代码有一个扎实的了解。我们还将在文章后面讨论将IronPDF与using语句结合的内容。

了解可释放对象和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别名指令

除了using语句的核心功能外，C#还提供各种功能，如using别名指令和使用区块内效率的局部变量管理，以进一步简化资源管理并提升代码可读性。

有时，当使用外部库或处理类名冲突时，我们的代码可能会变得杂乱且难以理解。 using别名指令通过允许我们为命名空间或类分配一个更易读或更短的别名来解决这个问题。

考虑一个场景，您正在处理两个同名但属于不同命名空间的类。您可以使用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 Generation是一个全面的PDF生成库，为.NET平台而设计，以C#为核心。 IronPDF通过利用HTML、CSS、图像和JavaScript来实现高效的PDF渲染，使PDF创建过程轻松。

它支持综合的PDF操作，简化了通常其他API较为复杂的任务。它不仅简化了PDF创建过程，还增加了对广泛应用类型的兼容性，包括Web、服务器、控制台和桌面应用程序。

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

使用Using语句的IronPDF示例

让我们把这一切与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