已更新 2026年4月23日
在 .NET 中用 Microsoft.Extensions.AI 簡化 LLM 整合
AI 正在改變軟體開發，但將大型語言模型 (LLM) 整合到 .NET 中一直很複雜。利用 IronPdf.AI 將 AI 整合推向更遠，為 .NET 應用程式帶來由 OpenAI 驅動的 PDF 解析、資料擷取和內容總結。
閱讀更多
開發者更新
C# Ref（對於開發者的運行原理）
Jacob Mellor
Updated: 2026年4月23日
在C#中，ref關鍵字是一個強大的功能，它允許方法修改傳遞的引用型別變數的參數值。 了解如何使用ref可以增強您在應用程式中管理和操作資料的能力。
本文將引導您了解ref關鍵字的基礎知識、其應用及在不同資料型別中使用這個關鍵字的細微差別。我們還將學習關於IronPDF for .NET，這是一個PDF程式庫。
理解ref參數
ref參數是一種方法參數，作用如同傳遞進方法的變數引用。 與標準值參數不同，僅傳遞變數的副本，ref參數允許被調用的方法修改原始變數的值。 當您需要方法來更新傳遞給它的變數狀態時，這種行為至關重要。
請參考以下範例來演示ref的基本使用，著重於參考型別變數如何在方法調用過程中保持相同物件中的參數值：
class Program
{
static void Main()
{
int number = 100;
ModifyNumber(ref number);
Console.WriteLine(number); // Output: 200
}
// Method that modifies the original number through 'ref'
static void ModifyNumber(ref int number)
{
number = 200; // Modifies the original value
}
}Friend Class Program
Shared Sub Main()
Dim number As Integer = 100
ModifyNumber(number)
Console.WriteLine(number) ' Output: 200
End Sub
' Method that modifies the original number through 'ref'
Private Shared Sub ModifyNumber(ByRef number As Integer)
number = 200 ' Modifies the original value
End Sub
End Class在此範例中，ref參數傳遞。 在Main方法中的原始值，並在主控台中列出200。
ref參數的工作原理
當您使用ref關鍵字宣告方法參數時，您告訴編譯器該參數將引用原始變數而非副本。 這是通過傳遞變數的記憶體地址而不是實際值來實現的。 調用方法和被調用方法均存取相同的記憶體位置，這意味著對參數所做的任何修改都是直接對原始變數的改動。
理解ref的關鍵在於認識到它可以用於值型別和引用型別。值型別包括像整數和結構這樣的簡單資料型別，而引用型別包括物件和陣列。 然而，即使引用型別變數本質上持有記憶體地址，使用ref與引用型別一起時，允許您修改實際引用，而不僅僅是物件的內容。
ref和out之間的區別
雖然out關鍵字都允許修改原始變數，但有重要的區別。 out參數在傳遞給方法之前不需要初始化。 反之，ref參數要求變數在傳遞之前必須初始化。 此外，使用out參數的方法有義務在方法返回之前分配一個值。 這一要求不適用於ref參數。
這是您可能使用out關鍵字的方式：
class Program
{
static void Main()
{
int result;
CalculateResult(out result);
Console.WriteLine(result); // Output: 100
}
// Method that calculates a result and assigns it via 'out'
static void CalculateResult(out int calculation)
{
calculation = 20 * 5; // Must initialize the out parameter
}
}Friend Class Program
Shared Sub Main()
Dim result As Integer = Nothing
CalculateResult(result)
Console.WriteLine(result) ' Output: 100
End Sub
' Method that calculates a result and assigns it via 'out'
Private Shared Sub CalculateResult(ByRef calculation As Integer)
calculation = 20 * 5 ' Must initialize the out parameter
End Sub
End Class在此情況下，Main則反映了結果。
ref在方法重載中的實際運用
ref關鍵字會改變方法簽名。 方法簽名由方法名及其參數型別組成，包括參數是由引用(out參數。
考慮基於ref和值參數的重載方法：
class Program
{
static void Main()
{
int normalParameter = 10, refParameter = 10;
IncrementValue(normalParameter);
IncrementValue(ref refParameter);
Console.WriteLine($"Normal: {normalParameter}, Ref: {refParameter}"); // Output: Normal: 10, Ref: 11
}
// Method that increments a copy of the integer
static void IncrementValue(int number)
{
number++;
}
// Method that increments the original integer using 'ref'
static void IncrementValue(ref int number)
{
number++;
}
}Friend Class Program
Shared Sub Main()
Dim normalParameter As Integer = 10, refParameter As Integer = 10
IncrementValue(normalParameter)
IncrementValue(refParameter)
Console.WriteLine($"Normal: {normalParameter}, Ref: {refParameter}") ' Output: Normal: 10, Ref: 11
End Sub
' Method that increments a copy of the integer
'INSTANT VB TODO TASK: VB does not allow method overloads which differ only in parameter ByVal/ByRef:
'ORIGINAL LINE: static void IncrementValue(int number)
Private Shared Sub IncrementValue(ByVal number As Integer)
number += 1
End Sub
' Method that increments the original integer using 'ref'
'INSTANT VB TODO TASK: VB does not allow method overloads which differ only in parameter ByVal/ByRef:
'ORIGINAL LINE: static void IncrementValue(ref int number)
Private Shared Sub IncrementValue(ByRef number As Integer)
number += 1
End Sub
End Class這裡，ref參數。 ref版本增加原始變數，而普通版本僅更改副本。
IronPDF簡介
IronPDF for .NET PDF Solutions是為處理PDF文件設計的綜合.NET程式庫。 它主要以C#構建，專注於簡化從HTML內容生成PDF的過程。 通過使用Chrome渲染引擎，IronPDF提供高質量、像素完美的PDF文件，捕捉HTML、CSS、JavaScript和圖像內容的細微差別。
此程式庫用途廣泛，支援多種.NET環境，包括.NET Framework、.NET Core和.NET Standard，使其適用於各種應用程式，從桌面到基於網頁的系統。 IronPDF不僅支援PDF建立，還提供編輯、保護及將PDF轉換為其他格式的功能。
這項功能擴展至文字和圖像提取、填寫表單，甚至應用數位簽章，確保在.NET應用程式中全面處理PDF文件。
將IronPDF與C#及ref關鍵字整合
IronPDF 可以與C#結合使用，以利用該語言的強大功能，包括使用ref關鍵字按引用傳遞參數。 這種整合允許動態生成PDF，其中內容可能依賴於執行時確定值的變數。
為說明使用ref關鍵字的IronPDF與C#整合，考慮一種情境，我們希望生成一份包含動態計算值的PDF報告。 此值將在接受ref參數的方法中進行計算，允許該方法修改此值，這之後會反映在生成的PDF中。
程式碼範例：使用ref生成具有動態內容的PDF
以下C#程式碼演示如何使用IronPDF與ref關鍵字結合以生成PDF文件。 程式碼計算一個值，並通過接受ref參數的方法進行修改，然後使用IronPDF生成包含此動態內容的PDF。
using IronPdf;
using System;
class Program
{
static void Main(string[] args)
{
// Set your IronPDF license key
License.LicenseKey = "License-Key";
// Initialize the value
int totalSales = 150;
// Modify the value within the method using 'ref'
AddMonthlyBonus(ref totalSales);
// Use IronPDF to generate a PDF report
var Renderer = new ChromePdfRenderer();
var PDF = Renderer.RenderHtmlAsPdf($"<h1>Monthly Sales Report</h1><p>Total Sales, including bonus: {totalSales}</p>");
// Save the PDF to a file
PDF.SaveAs("MonthlySalesReport.pdf");
// Confirm the PDF has been generated
Console.WriteLine("PDF generated successfully. Check your project directory.");
}
// Method that adds a monthly bonus to sales using 'ref'
static void AddMonthlyBonus(ref int sales)
{
// Assume a bonus of 10% of the sales
sales += (int)(sales * 0.1);
}
}Imports IronPdf
Imports System
Module Program
Sub Main(args As String())
' Set your IronPDF license key
License.LicenseKey = "License-Key"
' Initialize the value
Dim totalSales As Integer = 150
' Modify the value within the method using 'ByRef'
AddMonthlyBonus(totalSales)
' Use IronPDF to generate a PDF report
Dim Renderer = New ChromePdfRenderer()
Dim PDF = Renderer.RenderHtmlAsPdf($"<h1>Monthly Sales Report</h1><p>Total Sales, including bonus: {totalSales}</p>")
' Save the PDF to a file
PDF.SaveAs("MonthlySalesReport.pdf")
' Confirm the PDF has been generated
Console.WriteLine("PDF generated successfully. Check your project directory.")
End Sub
' Method that adds a monthly bonus to sales using 'ByRef'
Sub AddMonthlyBonus(ByRef sales As Integer)
' Assume a bonus of 10% of the sales
sales += CInt(sales * 0.1)
End Sub
End Module
在此範例中，ref關鍵字按引用接收此值，計算10%的獎金，並將其加到原始銷售值。 然後IronPDF生成一個PDF文件，其中包含報告總銷售額（包括獎金）的HTML片段。 最後的文件將以"MonthlySalesReport.pdf"保存到本地。
結論
在C#中理解ref關鍵字提供了管理方法之間如何傳遞資料的寶貴工具。 通過允許方法直接修改傳遞給它們的參數的原始值，ref可以使您的方法更具彈性和強大。
隨著您在使用ref上的經驗增長，您將更好地了解何時及如何有效地使用它來滿足您的程式設計需求。 IronPDF提供免費試用以開始使用PDF功能，價格從$999開始。
首席技術官
Jacob Mellor是Iron Software的首席技術官，一位在C# PDF技術上開創先河的遠見工程師。作為Iron Software核心程式碼庫的原開發者，他從創立以來就一直在塑造公司的產品架構，與首席執行官Cameron Rimington一起將公司轉變為服務於NASA、特斯拉和全球政府公司的50多名人員的公司。
...
閱讀更多相關文章
IronPDF 是 IRONSUITE 的一部分
10 款適用於辦公室文件的 .NET API 產品
當您需要您的PDF看起來像HTML一樣快速。
