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

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

この例では、Main メソッドは整数 number を宣言し、それを 100 に初期化します。次に、ModifyNumber を呼び出し、number を ref パラメータとして渡します。 ModifyNumber 内では、number の値が 200 に変更されます。number は参照渡しされるため、Main メソッド内の元の値に変更が反映され、コンソールに 200 が出力されます。

ref パラメーターの動作方法

ref キーワードを使用してメソッド パラメータを宣言すると、パラメータがコピーではなく元の変数を参照することをコンパイラに通知することになります。 これは、実際の値ではなく、変数のメモリ アドレスを渡すことで実現されます。 呼び出されたメソッドと呼び出しメソッドの両方が同じメモリ ロケーションにアクセスするため、パラメーターに対する変更は元の変数に直接適用されます。

ref を理解する鍵は、それが値型と参照型の両方で使用できることを認識することです。値型には整数や構造体などの単純なデータ型が含まれ、参照型にはオブジェクトや配列が含まれます。 ただし、参照型変数は本質的にメモリ アドレスを保持しますが、参照型で ref を使用すると、オブジェクトの内容だけでなく、実際の参照を変更できます。

ref と out の違い

ref と 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

この場合、CalculateResult はメソッド内の calculation を初期化し、Main は結果を反映します。

メソッド オーバーロードでの ref の実用的な使用

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

ここで、IncrementValue は、通常のパラメータを取るバージョンと ref パラメータを取るバージョンでオーバーロードされています。 ref バージョンは元の変数を増分しますが、通常のバージョンはコピーのみを変更します。

IronPDFの紹介

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 ドキュメントの包括的な処理を保証します。

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

Friend Class Program
	Shared Sub Main(ByVal 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 'ref'
		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 'ref'
	Private Shared Sub AddMonthlyBonus(ByRef sales As Integer)
		' Assume a bonus of 10% of the sales
		sales += CInt(Math.Truncate(sales * 0.1))
	End Sub
End Class

結論

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

ref の使用経験を積むにつれて、プログラミングのニーズを満たすために、いつ、どのようにこれを効果的に使用すればよいかをより深く理解できるようになります。 IronPDF、PDF 機能の使用を開始するための無料トライアルを提供しており、価格は $999 から始まります。