C# 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

在上面的範例中，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
    // 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

使用別名指令

除了 using 語句的核心功能之外，C# 還提供了 using alias 指令以及在 using 區塊中有效處理 local 變數等功能，以進一步簡化資源管理並提高程式碼的可讀性。

有時候，在使用外部程式庫或處理類別名稱衝突時，我們的程式碼會變得雜亂無章，難以遵循。 using alias 指令可讓我們為命名空間或類別指定更易讀或更簡短的別名。

讓我們考慮一種情況，您正在使用兩個具有相同名稱但位於不同命名空間的不同類別。 您可以使用 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.

使用聲明

在 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

自訂類別與 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

當您的類別實作了 IDisposable，您就可以像使用其他一次性物件一樣，在 using 語句中使用它。

安裝 IronPDF。

將 IronPDF 加入專案的最有效方式是透過 NuGet 套件管理員。 只需在 Visual Studio 中開啟您的專案，導覽到 "Solution Explorer"，在 "Dependencies" 上按一下滑鼠右鍵，然後選擇 "Manage NuGet Packages"。在此，您可以搜索 "IronPDF"，只需點擊幾下即可安裝套件。

使用 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

許可證

IronPDF 提供多種不同需求的 License 選項，以適應不同的團隊規模和部署需求，確保各種規模的開發人員和組織都能靈活使用。

許可證價格從 $999 起。 它提供 免費試用 IronPDF 功能，以便在購買前測試其功能。