.NET 幫助

C# 使用語句（為開發人員工作的方式）

Name: IronPDF
Brand: Iron Software
Availability: InStock
Rating: 4.87 (307 reviews)

奇佩戈·卡林达

2024年4月3日

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
}

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

$vbLabelText $csharpLabel

在上述範例中，StreamReader 是一個實作 IDisposable 介面的類別。 using 語句確保當控制離開大括號定義的範圍時，自動調用 reader 的 Dispose 方法。

工作原理

當您使用 using 語句包裝可釋放物件時，基本上會轉換為包含 finally 區塊的 try 區塊。在finally區塊中，會調用Dispose方法，確保即使發生異常也能正確釋放資源。

如果使用區塊中的程式碼拋出錯誤，別擔心； 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

$vbLabelText $csharpLabel

使用別名指令

除了 using 語句的核心功能外，C# 還提供了如 using 別名指令和在 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.

$vbLabelText $csharpLabel

使用宣告

自 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

$vbLabelText $csharpLabel

自定義類別和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

$vbLabelText $csharpLabel

隨著您的類實現 IDisposable，您可以像使用任何其他可釋放對象一樣在 using 語句中使用它。

IronPDF簡介：C# PDF庫

C# 使用語句（它如何為開發人員工作）：圖 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

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# 使用語句（開發人員如何運作）：圖 3

許可證

C# Using 語句（開發者如何使用）：圖4

IronPDF 提供多種授權選擇以滿足不同需求，以適應不同團隊規模和部署需求，確保為各種規模的開發人員和組織提供靈活性。

許可證價格從$749開始。它提供IronPDF 功能的免費試用，可在購買前測試其功能。

結論與最佳實踐

using 語句是在 C# 中的一個強大功能，能確保資源的高效管理和更乾淨的代碼。這在處理文件流、資料庫連接或任何其他占用系統資源的本地變量或對象時特別有用。

通過自動調用Dispose方法，它有助於防止資源洩漏，並保持您的應用程式順利運行。請記得對任何實作IDisposable介面的物件，始終使用using語句。

IronPDF 邀請您使用他們的IronPDF 免費試用來嘗試該產品，而無需任何財務義務。如果您對其性能滿意，獲取授權的起價為$749。

奇佩戈·卡林达

立即與工程團隊聊天

軟體工程師

Chipego 擁有天生的傾聽技能，這幫助他理解客戶問題，並提供智能解決方案。他在獲得信息技術理學學士學位後，于 2023 年加入 Iron Software 團隊。IronPDF 和 IronOCR 是 Chipego 專注的兩個產品，但隨著他每天找到新的方法來支持客戶，他對所有產品的了解也在不斷增長。他喜歡在 Iron Software 的協作生活，公司內的團隊成員從各自不同的經歷中共同努力，創造出有效的創新解決方案。當 Chipego 離開辦公桌時，他常常享受讀好書或踢足球的樂趣。

< 上一頁
C# Tryparse（對開發人員的運作方式）

下一個 >
C# 記錄（它如何對開發人員起作用）