C# Ref (Jak to działa dla programistów)

Zrozumienie parametrów ref

Parametr ref jest parametrem metody, który działa jako odniesienie do zmiennej przekazywanej do metody. W przeciwieństwie do standardowych parametrów wartości, gdzie przekazywana jest tylko kopia zmiennej, parametry ref pozwalają wywoływanej metodzie zmienić wartość oryginalnej zmiennej. Takie zachowanie ma kluczowe znaczenie, gdy potrzebna jest metoda do aktualizacji stanu przekazanych do niej zmiennych.

Rozważ poniższy przykład, aby zademonstrować podstawowe użycie ref, koncentrując się na tym, jak zmienna typu referencyjnego zachowuje swoją wartość parametru w tym samym obiekcie podczas wywołań metody:

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

W tym przykładzie metoda Main deklaruje liczbę całkowitą number i inicjalizuje ją wartością 100. Następnie wywołuje ModifyNumber, przekazując number jako parametr ref. Wewnątrz ModifyNumber wartość number jest zmieniana na 200. Ponieważ number jest przekazywana przez referencję, zmiana jest odzwierciedlona w oryginalnej wartości w metodzie Main i 200 jest drukowane na konsolę.

Jak działają parametry ref

Gdy deklarujesz parametr metody ze słowem kluczowym ref, informujesz kompilator, że parametr będzie odnosił się do oryginalnej zmiennej, a nie do kopii. Osiąga się to poprzez przekazywanie adresu pamięci zmiennej, a nie jej rzeczywistej wartości. Zarówno metoda wywoływana, jak i metoda wywołująca mają dostęp do tej samej lokalizacji w pamięci, co oznacza, że wszelkie zmiany wprowadzone w parametrze są wprowadzane bezpośrednio do oryginalnej zmiennej.

Kluczem do zrozumienia ref jest rozpoznanie, że może być używane zarówno z typami wartościowymi, jak i referencyjnymi. Typy wartościowe obejmują proste typy danych jak liczby całkowite i struktury, podczas gdy typy referencyjne obejmują obiekty i tablice. Jednakże, chociaż zmienne typu referencyjnego z natury przechowują adresy pamięci, użycie ref z typami referencyjnymi pozwala na modyfikację rzeczywistego odniesienia, a nie tylko zawartości obiektu.

Różnice między ref a out

Chociaż zarówno słowa kluczowe ref, jak i out umożliwiają modyfikację oryginalnych zmiennych, istnieją ważne różnice. Parametr out nie wymaga inicjalizacji przed przekazaniem do metody. Z kolei parametr ref wymaga inicjalizacji zmiennej przed jej przekazaniem. Ponadto, metoda używająca parametru out ma obowiązek przypisania wartości przed zakończeniem metody. Ten wymóg nie dotyczy parametrów ref.

Oto jak możesz użyć słowa kluczowego 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

W tym przypadku CalculateResult inicjalizuje calculation wewnątrz metody, a Main odzwierciedla wynik.

Praktyczne zastosowanie ref w przeciążaniu metod

ref może być również używane w przeciążaniu metod, gdzie podpis metody jest zmieniany przez słowo kluczowe ref. Podpisy metod składają się z nazwy metody i jej typów parametrów, w tym informacji, czy parametry są przekazywane przez referencję (ref), przez wartość, czy jako parametr out.

Rozważ przeciążanie metod opartych na ref i parametrach wartościowych:

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

Tutaj IncrementValue jest przeciążane z jednej wersji przyjmującej normalny parametr, a drugą przyjmującą parametr ref. Wersja ref zwiększa wartość oryginalnej zmiennej, podczas gdy normalna wersja zmienia tylko kopię.

Wprowadzenie do IronPDF

IronPDF dla .NET PDF Solutions to kompleksowa biblioteka .NET przeznaczona do pracy z dokumentami PDF. Jest napisany głównie w języku C# i skupia się na upraszczaniu tworzenia i edycji plików PDF na podstawie treści HTML. Dzięki wykorzystaniu silnika renderującego Chrome, IronPDF zapewnia wysokiej jakości dokumenty PDF o idealnej rozdzielczości, które oddają niuanse treści HTML, CSS, JavaScript i obrazów.

Biblioteka ta jest wszechstronna i obsługuje szeroki zakres środowisk .NET, w tym .NET Framework, .NET Core i .NET Standard, dzięki czemu nadaje się do różnych zastosowań, od systemów desktopowych po systemy internetowe. IronPDF nie tylko obsługuje tworzenie plików PDF, ale oferuje również funkcje edycji, zabezpieczania i konwersji plików PDF do innych formatów.

Ta funkcja obejmuje również wyodrębnianie tekstu i obrazów, wypełnianie formularzy, a nawet stosowanie podpisów cyfrowych, zapewniając kompleksową obsługę dokumentów PDF w aplikacjach .NET.

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

Wnioski

Zrozumienie słowa kluczowego ref w C# dostarcza cennego narzędzia do zarządzania sposobem przekazywania danych między metodami. Pozwalając metodom bezpośrednio modyfikować oryginalne wartości przekazanych im parametrów, ref może uczynić twoje metody bardziej elastycznymi i wydajnymi.

Zyskując doświadczenie z ref, lepiej zrozumiesz, kiedy i jak efektywnie je wykorzystywać, aby sprostać swoim potrzebom programistycznym. IronPDF oferuje bezpłatną wersję próbną, aby rozpocząć pracę z możliwościami PDF i ceny zaczynają się od $999.