.NET 帮助

C# Using 语句（它是如何为开发人员工作的）

发布 2024年四月3日

"(《世界人权宣言》)使用语句在 C# 中，"资源 "是一个基本概念，有助于有效管理资源，尤其是在处理一次性对象时。本教程将详细介绍什么是using语句、它是如何工作的，以及为什么它有好处，尤其是对于那些 C# 的新手来说。

在本指南结束时，您将充分了解如何在代码中执行此语句，以实现更好的资源管理和更简洁、更易读的代码。我们还将讨论将 IronPDF 与 using 语句相整合在文章的后面。

了解一次性对象和 IDisposable 接口

在深入了解using语句之前，了解一次性对象和IDisposable接口至关重要。在 .NET 中，垃圾回收器不管理文件句柄、网络连接和数据库连接等许多资源。

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

使用说明的基础知识

语法和用法

使用*语句简化了释放非托管资源的过程。它可确保在一次性对象退出作用域后立即调用该对象的Dispose**方法。

将 using 块视为安全区，确保资源在使用后自动清理。下面是一个基本示例来说明其用法：

using (StreamReader reader = new StreamReader("file.txt"))
{
    // You can read the file here
}

using (StreamReader reader = new StreamReader("file.txt"))
{
    // You can read the file here
}

Using reader As New StreamReader("file.txt")
	' You can read the file here
End Using

VB C#

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

如何工作

当您用using语句包装一个一次性对象时，它本质上相当于一个try块和一个finally块。在finally块中，将调用Dispose方法，以确保即使出现异常也能正确释放资源。

如果 using 块中的代码出错，请不要担心；在此情况下，Dispose 方法仍将被调用，以确保安全地释放资源。

使用声明的高级概念

管理多种资源

您可以在一个using语句中管理多个一次性对象。这种方法可以使您的代码更加简洁，并确保正确处理所有资源：

using (SqlConnection conn = new SqlConnection(connString))
using (SqlCommand cmd = new SqlCommand(query, conn))
{
    // Work with your database here
}

using (SqlConnection conn = new SqlConnection(connString))
using (SqlCommand cmd = new SqlCommand(query, conn))
{
    // Work with your database here
}

Using conn As New SqlConnection(connString)
Using cmd As New SqlCommand(query, conn)
	' Work with your database here
End Using
End Using

VB C#

使用别名指令

除了using语句的核心功能外，C#还提供了using别名指令和在using块中有效处理本地变量等功能，以进一步简化资源管理并增强代码的可读性。

有时，在使用外部库或处理类名冲突时，我们的代码会变得杂乱无章、难以理解。使用别名指令***可以帮助我们为命名空间或类指定一个更易读或更简短的别名。

让我们考虑这样一种情况：您正在处理两个名称相同但位于不同命名空间的不同类。您可以使用 using alias 指令轻松区分它们：

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.

VB C#

使用声明

在 C# 8.0 中引入的using声明是一种语法糖，可使您的代码更加简洁。您无需用大括号包装一次性对象，只需对其进行声明，它就会在声明的作用域结束时被弃置：

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

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

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

VB C#

自定义类和 IDisposable

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

public class ResourceHolder : IDisposable
{
    public void Dispose()
    {
        // Release your resources here
    }
}

public class ResourceHolder : IDisposable
{
    public void Dispose()
    {
        // Release your resources here
    }
}

Public Class ResourceHolder
	Implements IDisposable

	Public Sub Dispose() Implements IDisposable.Dispose
		' Release your resources here
	End Sub
End Class

VB C#

如果你的类实现了 IDisposable，你就可以在 using语句中使用它，就像使用其他一次性对象一样。

IronPDF 简介：C# PDF 库

C# Using Statement（如何为开发人员工作）：图 1

IronPDF for .NET PDF 生成工具PDF 生成库是一个综合性 PDF 生成库，专为 .NET 平台设计，以 C# 为核心。 IronPDF 使PDF 创建过程简单通过利用 HTML、CSS、图像和 JavaScript 实现高效的 PDF 渲染。

它支持全面的 PDF 操作，简化了使用其他 API 时通常很复杂的任务。它不仅简化了 PDF 创建过程，还增加了对各种应用程序类型的兼容性，包括网络、服务器、控制台和桌面应用程序。

安装 IronPDF

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

C# Using Statement（如何为开发人员工作）：图 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

VB C#

C# Using Statement（如何为开发人员工作）：图 3