C# Przekazywanie przez referencję (jak to działa dla programistów)

Jak korzystać z C# Pass by Reference

1. Zdefiniuj metodę z parametrami ref.
2. Zainicjuj zmienną.
3. Wywołaj metodę za pomocą słowa kluczowego Ref.
4. Zmodyfikuj zmienną wewnątrz metody.
5. Obserwuj zmiany w metodzie Main.
6. Zdefiniuj inną metodę z parametrem Out do generowania plików PDF.
7. Zainicjuj i wywołaj metodę Out.

Czym jest przekazywanie przez referencję w języku C#?

Wykorzystanie przekazywania przez referencję odnosi się do sposobu, w jaki w języku C# wysyła się argumenty do funkcji lub metod, podając referencję do zmiennej początkowej wywoływanej metody zamiast kopii jej wartości. Oznacza to, że wszelkie zmiany wprowadzone w parametrze wewnątrz metody będą miały również wpływ na zmienną początkową poza metodą.

Zmienne typu wartościowego w języku C# (takie jak int, float, bool itp.) są zazwyczaj przekazywane przez wartość, co oznacza, że metoda otrzymuje kopię wartości zmiennej. Niemniej jednak można nakazać kompilatorowi przekazywanie argumentów przez odwołanie, używając słowa kluczowego ref.

class Program
{
    static void Main(string[] args)
    {
        int num = 10;
        Console.WriteLine("Before: " + num); // Output: Before: 10
        ModifyByRef(ref num);
        Console.WriteLine("After: " + num);  // Output: After: 20
    }

    // Method that modifies the integer by reference
    static void ModifyByRef(ref int x)
    {
        x = x * 2; // Modify the original value by reference
    }
}

class Program
{
    static void Main(string[] args)
    {
        int num = 10;
        Console.WriteLine("Before: " + num); // Output: Before: 10
        ModifyByRef(ref num);
        Console.WriteLine("After: " + num);  // Output: After: 20
    }

    // Method that modifies the integer by reference
    static void ModifyByRef(ref int x)
    {
        x = x * 2; // Modify the original value by reference
    }
}

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim num As Integer = 10
		Console.WriteLine("Before: " & num) ' Output: Before: 10
		ModifyByRef(num)
		Console.WriteLine("After: " & num) ' Output: After: 20
	End Sub

	' Method that modifies the integer by reference
	Private Shared Sub ModifyByRef(ByRef x As Integer)
		x = x * 2 ' Modify the original value by reference
	End Sub
End Class

class Program
{
    static void Main(string[] args)
    {
        int result;
        Calculate(10, 5, out result);
        Console.WriteLine("Result: " + result); // Output: Result: 15
    }

    // Method that calculates the sum of two integers and outputs the result by reference
    static void Calculate(int x, int y, out int result)
    {
        result = x + y; // Assign the sum to the out parameter
    }
}

class Program
{
    static void Main(string[] args)
    {
        int result;
        Calculate(10, 5, out result);
        Console.WriteLine("Result: " + result); // Output: Result: 15
    }

    // Method that calculates the sum of two integers and outputs the result by reference
    static void Calculate(int x, int y, out int result)
    {
        result = x + y; // Assign the sum to the out parameter
    }
}

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim result As Integer = Nothing
		Calculate(10, 5, result)
		Console.WriteLine("Result: " & result) ' Output: Result: 15
	End Sub

	' Method that calculates the sum of two integers and outputs the result by reference
	Private Shared Sub Calculate(ByVal x As Integer, ByVal y As Integer, ByRef result As Integer)
		result = x + y ' Assign the sum to the out parameter
	End Sub
End Class

// Method that modifies multiple variables by reference
static void ModifyMultipleByRef(ref int a, ref int b)
{
    a *= 2; // Double the first variable
    b *= 3; // Triple the second variable
}

// Method that modifies multiple variables by reference
static void ModifyMultipleByRef(ref int a, ref int b)
{
    a *= 2; // Double the first variable
    b *= 3; // Triple the second variable
}

' Method that modifies multiple variables by reference
Shared Sub ModifyMultipleByRef(ByRef a As Integer, ByRef b As Integer)
	a *= 2 ' Double the first variable
	b *= 3 ' Triple the second variable
End Sub

Czym jest IronPDF?

IronPDF umożliwia programistom tworzenie, modyfikowanie i renderowanie dokumentów PDF w aplikacjach .NET. Jego bogaty zestaw funkcji sprawia, że praca z plikami PDF jest prosta. Możesz tworzyć dokumenty PDF z plików HTML, zdjęć i innych formatów; opisywać pliki PDF tekstem, obrazami i innymi danymi; oraz dzielić, łączyć i edytować istniejące dokumenty PDF.

Główną funkcją IronPDF jest możliwość konwersji HTML do formatu PDF z zachowaniem układu i stylów. Ta funkcja doskonale nadaje się do generowania plików PDF z treści internetowych, takich jak raporty, faktury i dokumentacja. Konwertuje pliki HTML, adresy URL i ciągi znaków HTML na pliki 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");
    }
}

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

Utwórz nowy projekt Visual Studio

Instalacja IronPDF

W sekcji Narzędzia w Visual Studio Tools można znaleźć interfejs Visual Command-Line. Wybierz menedżera pakietów dla NuGet. W zakładce terminala zarządzania pakietami należy wpisać następujące polecenie.

Install-Package IronPdf

Dodatkową alternatywą jest użycie menedżera pakietów. Instalacja pakietu bezpośrednio w rozwiązaniu jest możliwa dzięki opcji NuGet Package Manager. Aby znaleźć pakiety, skorzystaj z pola wyszukiwania na stronie NuGet. Poniższy przykładowy zrzut ekranu ilustruje, jak łatwo jest wyszukać "IronPDF" w menedżerze pakietów:

Listę odpowiednich wyników wyszukiwania można zobaczyć na powyższym obrazku. Aby umożliwić instalację oprogramowania na komputerze, prosimy o dostosowanie tych ustawień.

Po pobraniu i zainstalowaniu pakietu można go używać w bieżącym projekcie.

using IronPdf;
using System;

class Program
{
    static void Main(string[] args)
    {
        // Create a PDF document
        var pdf = new IronPdf.HtmlToPdf();
        // HTML content to be converted to PDF
        string htmlContent = "<h1>Hello, IronPDF!</h1>";
        // Create a byte array to store the PDF content
        byte[] pdfBytes;
        // Convert HTML to PDF and pass the byte array by reference
        ConvertHtmlToPdf(pdf, htmlContent, out pdfBytes);
        // Save or process the PDF content
        // For demonstration, let's print the length of the PDF content
        Console.WriteLine("Length of PDF: " + pdfBytes.Length);
    }

    // Method that converts HTML content to PDF and stores it in a byte array by reference
    static void ConvertHtmlToPdf(IronPdf.HtmlToPdf pdfConverter, string htmlContent, out byte[] pdfBytes)
    {
        // Convert HTML to PDF and store the result in the byte array
        var pdfDoc = pdfConverter.RenderHtmlAsPdf(htmlContent);
        pdfBytes = pdfDoc.BinaryData;
    }
}

using IronPdf;
using System;

class Program
{
    static void Main(string[] args)
    {
        // Create a PDF document
        var pdf = new IronPdf.HtmlToPdf();
        // HTML content to be converted to PDF
        string htmlContent = "<h1>Hello, IronPDF!</h1>";
        // Create a byte array to store the PDF content
        byte[] pdfBytes;
        // Convert HTML to PDF and pass the byte array by reference
        ConvertHtmlToPdf(pdf, htmlContent, out pdfBytes);
        // Save or process the PDF content
        // For demonstration, let's print the length of the PDF content
        Console.WriteLine("Length of PDF: " + pdfBytes.Length);
    }

    // Method that converts HTML content to PDF and stores it in a byte array by reference
    static void ConvertHtmlToPdf(IronPdf.HtmlToPdf pdfConverter, string htmlContent, out byte[] pdfBytes)
    {
        // Convert HTML to PDF and store the result in the byte array
        var pdfDoc = pdfConverter.RenderHtmlAsPdf(htmlContent);
        pdfBytes = pdfDoc.BinaryData;
    }
}

Imports IronPdf
Imports System

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		' Create a PDF document
		Dim pdf = New IronPdf.HtmlToPdf()
		' HTML content to be converted to PDF
		Dim htmlContent As String = "<h1>Hello, IronPDF!</h1>"
		' Create a byte array to store the PDF content
		Dim pdfBytes() As Byte = Nothing
		' Convert HTML to PDF and pass the byte array by reference
		ConvertHtmlToPdf(pdf, htmlContent, pdfBytes)
		' Save or process the PDF content
		' For demonstration, let's print the length of the PDF content
		Console.WriteLine("Length of PDF: " & pdfBytes.Length)
	End Sub

	' Method that converts HTML content to PDF and stores it in a byte array by reference
	Private Shared Sub ConvertHtmlToPdf(ByVal pdfConverter As IronPdf.HtmlToPdf, ByVal htmlContent As String, ByRef pdfBytes() As Byte)
		' Convert HTML to PDF and store the result in the byte array
		Dim pdfDoc = pdfConverter.RenderHtmlAsPdf(htmlContent)
		pdfBytes = pdfDoc.BinaryData
	End Sub
End Class

Wnioski

Podsumowując, użycie IronPDF z przekazywaniem przez referencję w C# znacznie poprawia możliwości tworzenia i modyfikowania dokumentów PDF w programach .NET. Skuteczne wykorzystanie słów kluczowych ref i out pozwala programistom z łatwością przekazywać argumenty przez odwołanie, umożliwiając szybką i wydajną modyfikację zmiennych oraz treści w ramach metod. Szeroki zakres funkcji IronPDF, obejmujący możliwość konwersji HTML do PDF, generowania plików PDF na podstawie obrazów oraz wykonywania rozbudowanych zadań związanych z modyfikacją plików PDF, umożliwia programistom łatwe tworzenie dynamicznych i interaktywnych dokumentów PDF.

IronPDF oferuje narzędzia i interfejsy API niezbędne do przyspieszenia procesów przetwarzania dokumentów, w tym dzielenia, łączenia, dodawania adnotacji i optymalizacji plików PDF. Ponadto wieloplatformowa interoperacyjność IronPDF gwarantuje, że aplikacje C# mogą z łatwością wykorzystywać funkcje PDF w różnych środowiskach. Zasadniczo programiści mogą stworzyć nowe możliwości tworzenia, modyfikowania i wyświetlania dokumentów PDF w swoich aplikacjach, łącząc zalety przekazywania przez referencję w języku C# z bogatym zestawem funkcji IronPDF.

Ponadto można efektywnie pracować z programem Excel, tworzyć pliki PDF, przeprowadzać rozpoznawanie optyczne (OCR) oraz korzystać z BARCODE-ów. Ceny poszczególnych bibliotek zaczynają się od $799. Programiści mogą z pewnością wybrać najlepszy model, jeśli dostępne są jasne opcje licencji dostosowane do potrzeb projektu. Dzięki tym zaletom programiści mogą skutecznie i przejrzyście radzić sobie z różnorodnymi wyzwaniami.