C# では、参照型変数のパラメータ値をどのように修正できますか？

C# では、メソッドが参照型変数のパラメータ値を修正できるようにするために ref キーワードを使用できます。これにより、オリジナルの変数自体を変更することが可能で、コピーだけを変更するのではありません。

C# における ref キーワードと out キーワードの違いは何ですか？

ref キーワードは、変数がメソッドに渡される前に初期化されている必要がありますが、 out キーワードは事前の初期化を必要とせず、メソッドが値を返す前に値を割り当てることを要求します。

C# では ref キーワードは値型と参照型の両方に使用できますか？

はい、 ref キーワードは値型（整数など）や参照型（オブジェクトなど）に使用でき、メソッドが実際のデータまたは参照自体を修正することを可能にします。

C# のメソッドオーバーロードで ref キーワードはどのように利用されますか？

ref キーワードはメソッドオーバーロードでメソッドシグネチャを区別するために使用できます。これにより、参照渡しや値渡しに基づいて異なるメソッドを呼び出すことができます。

C# で PDF ドキュメントを作成および操作するにはどうすればいいですか？

IronPDF を使用することで、.NET ライブラリとして PDF ドキュメントを作成および操作できます。編集、セキュリティ保護、PDF 変換などの機能を提供し、さまざまな .NET 環境に対応しています。

.NET PDF ライブラリを C# と ref キーワードを使ってどのように統合するか？

データを表す変数を渡して修正するために ref キーワードを利用することで、C# と IronPDF を統合して動的な PDF を生成できます。

C# メソッドにおける ref キーワードの実用的な使用例は何ですか？

ref キーワードの実用的な使用例は、メソッド内で変数の値を変更して、その変更がメソッドの外で反映されるようにすることです。例えば、レポートの財務合計を調整する場合などです。

C# において ref キーワードを使用するとメソッドの柔軟性がどのように向上しますか？

ref キーワードは、元のパラメータ値を直接修正することを可能にし、データ管理や複数回のメソッド呼び出しによる更新を容易にすることで、メソッドの柔軟性を向上させます。

C# で ref キーワードを使用するときにどのような注意を払うべきですか？

C# で ref キーワードを使用する場合、メソッドに渡す前に変数が初期化されていることを確認してください。 ref は事前に初期化された変数を必要とします。

.NET ライブラリによる PDF 操作に関する情報はどこで取得できますか？

IronPDF に関する詳細情報は、公式ウェブサイトで入手でき、その機能や統合の詳細も確認できるほか、無料トライアルや価格情報も提供しています。

C# PDFライブラリ

Explore IronPDF 無料トライアル

HTML から PDF へ

Online Demo すべてのコード例を見る

using IronPdf;

// Disable local disk access or cross-origin requests
Installation.EnableWebSecurity = true;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from a HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");

// Advanced Example with HTML Assets
// Load external html assets: Images, CSS and JavaScript.
// An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");
myAdvancedPdf.SaveAs("html-with-assets.pdf");

using IronPdf;

// Disable local disk access or cross-origin requests
Installation.EnableWebSecurity = true;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from a HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");

// Advanced Example with HTML Assets
// Load external html assets: Images, CSS and JavaScript.
// An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");
myAdvancedPdf.SaveAs("html-with-assets.pdf");

PM >Install-Package IronPdf

Install-Package IronPdf

開発者向けアップデート

C# Ref（開発者向けの動作方法）

Jacob Mellor

Updated: 2026年4月23日

C# では、ref キーワードは、メソッドが渡された参照型変数のパラメーター値を変更できる強力な機能です。アプリケーション内でのデータ管理と操作の能力を向上させるために、refの使い方を理解することが重要です。

この記事では、refキーワードの基本、適用方法、および異なるデータ型での使用のニュアンスを案内します。また、IronPDF library 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
    }
}

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

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
    }
}

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

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キーワードによってメソッドシグネチャが変更されます。メソッドシグネチャは、メソッド名とそのパラメータ型で構成され、参照によってパラメータが渡されるか(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++;
    }
}

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

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の紹介

C#参照 (開発者向けの仕組み): 図1

IronPDF .NET 向け PDF Solutions は、PDF ドキュメントを操作するために設計された包括的な .NET ライブラリです。主に C# で構築されており、HTML コンテンツから PDF を作成することを簡素化することに焦点を当てています。 IronPDF は Chrome レンダリングエンジンを採用しており、HTML、CSS、JavaScript、画像コンテンツのニュアンスを捉えた高品質でピクセルパーフェクトな PDF ドキュメントを提供します。

このライブラリは柔軟で、.NET Framework、.NET Core、.NET Standard を含む幅広い .NET 環境をサポートしており、デスクトップから Web ベースのシステムまでさまざまなアプリケーションに適しています。 IronPDF は PDF の作成をサポートするだけでなく、PDF を編集、セキュリティ保護、他のフォーマットに変換する機能も提供します。

これには、テキストや画像の抽出、フォームの記入、デジタル署名の適用が可能であり、.NET アプリケーション内での PDF ドキュメントの包括的な処理を保証します。

IronPDF の C# および ref キーワードとの統合

IronPDFはC#と統合し、言語の強力な機能を活用できます。これには、参照としてパラメータを渡すためにrefキーワードを使用することも含まれます。この統合により、内容がランタイム時に決定される変数に依存する場合がある動的な PDF の生成が可能になります。

C#とrefキーワードを使用してIronPDFを統合する例として、動的に計算された値を含むPDFレポートを生成したいシナリオを考えてみましょう。この値はメソッド内で計算され、refパラメータを受け入れることでメソッドがこの値を修正し、その後に生成されたPDFに反映されます。

コード例: ref を使用して動的コンテンツを含む PDF の生成

次のC#コードは、refキーワードと併せてIronPDFを使用して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);
    }
}

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

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

C#参照 (開発者向けの仕組み): 図2

この例では、refキーワードを使ってこの値を参照によって受け取り、10%のボーナスを計算し、それを元の売上値に追加します。 IronPDF は、ボーナスを含む総売上を報告する HTML スニペットを含む PDF ドキュメントを生成します。最終的なドキュメントは"MonthlySalesReport.pdf"としてローカルに保存されます。

結論

C#のrefキーワードを理解することは、メソッド間でデータがどのように渡されるかを管理するための貴重なツールとなります。メソッドが渡されたパラメータの元の値を直接変更できるようにすることで、refはメソッドをより柔軟で強力なものにすることができます。

refについての経験を積むと、それを効果的に使用するための適切なタイミングと方法をよりよく理解するようになります。 IronPDFは無料トライアルでPDF機能を始めることができ、価格は$999からです。

Jacob Mellor

今すぐエンジニアリングチームとチャット

最高技術責任者（CTO）

ジェイコブ・メラーはIron Softwareの最高技術責任者（CTO）であり、C# PDFテクノロジーを開拓する先見的なエンジニアです。Iron Softwareのコアコードベースを支えるオリジナル開発者として、彼は創業以来、会社の製品アーキテクチャを形成し、CEOのCameron Rimingtonとともに、会社をNASA、Tesla、および世界的な政府機関にサービスを提供する50人以上の会社に変えました。1999年にロンドンで最初のソフトウェアビジネスを開業し、2005年に最初 for .NETコンポーネントを作成した後、Microsoftのエコシステム全体で複雑な問題を解決することを専門としました。