Stwórz plik PDF z przewodnika Blazor

Tworzenie nowego projektu w Visual Studio

Aby rozpocząć, otwórz aplikację Microsoft Visual Studio i wybierz opcję "Nowy projekt" z menu Plik. Następnie wybierz "Blazor Server App".

Tworzenie nowego projektu w Visual Studio

Wprowadź nazwę projektu i wybierz ścieżkę do pliku. Następnie kliknij przycisk Utwórz.

Wybór nazwy i lokalizacji nowej aplikacji Blazor

Wybierz żądany .NET Framework (w tym samouczku użyjemy .NET Framework 6.0), jak pokazano na poniższym zrzucie ekranu:

Tworzenie nowego projektu w Visual Studio z wykorzystaniem .NET Framework 6.0

Microsoft Visual Studio wygeneruje teraz strukturę tej aplikacji Blazor.

Następnie dodaj bibliotekę IronPDF do tego nowego projektu.

3.1 Korzystanie z menedżera pakietów NuGet w Visual Studio

Visual Studio udostępnia menedżera pakietów NuGet, który ułatwia instalowanie bibliotek bezpośrednio w projektach. Poniższy zrzut ekranu pokazuje, jak otworzyć menedżera pakietów NuGet.

Dostęp do menedżera pakietów NuGet w Visual Studio

Użyj pola wyszukiwania w zakładce Przeglądaj, aby wyszukać "IronPDF", jak pokazano na poniższym zrzucie ekranu:

Wyszukiwanie biblioteki IronPDF w interfejsie graficznym menedżera pakietów NuGet

Na powyższym obrazku widoczna jest lista powiązanych wyników wyszukiwania. Wybierz wymagane opcje, aby zainstalować pakiet w swoim projekcie.

3.2 Korzystanie z wiersza poleceń programu Visual Studio

W programie Visual Studio przejdź do menu Narzędzia > Menedżer pakietów NuGet > Konsola menedżera pakietów

Wprowadź następujący wiersz w zakładce Konsola menedżera pakietów:

Install-Package IronPdf

Pakiet zostanie teraz pobrany i zainstalowany w bieżącym projekcie.

Instalacja biblioteki IronPDF za pomocą konsoli NuGet Package Manager Console

3.3 Pobieranie bezpośrednio ze strony NuGet

Trzecim sposobem instalacji biblioteki IronPDF jest pobranie pakietu NuGet bezpośrednio ze strony internetowej.

Przejdź do strony NuGet poświęconej IronPDF.

• Kliknij opcję "Pobierz pakiet" w menu po prawej stronie.
• Otwórz pobrany pakiet w swoim systemie plików. Zostanie zainstalowany automatycznie.
• Odśwież rozwiązanie i zacznij z niego korzystać w swoim projekcie.

3.4 Pobieranie bezpośrednio ze strony internetowej IronPDF

Odwiedź stronę internetową IronPDF, aby bezpośrednio pobrać pakiet IronPDF.

Po pobraniu wykonaj następujące kroki, aby dodać pakiet do swojego projektu:

• Kliknij prawym przyciskiem myszy projekt w oknie rozwiązania.
• Wybierz opcję "Dodaj" > "Odwołanie", a następnie przejdź do lokalizacji biblioteki, którą wcześniej pobrałeś.
• Kliknij OK, aby dodać bibliotekę jako odwołanie.

4. Tworzenie dokumentów PDF w aplikacji Blazor Server

Aplikacja Blazor w tym samouczku będzie korzystać z IronPDF do pobierania treści HTML strony internetowej na podstawie jej adresu URL i konwertowania jej na dokument PDF.

Wprowadź poniższy kod źródłowy do pliku .razor znajdującego się w projekcie.

@using IronPdf

@code {
    /// <summary>
    /// This method exports data by converting a URL to a PDF file and initiating its download.
    /// </summary>
    public async Task ExportData()
    {
        try
        {
            string fileName = "Demo.pdf";
            var renderer = new ChromePdfRenderer();

            // Render the contents of the URL as a PDF document
            var pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata");

            // Save the PDF using a JavaScript function
            await JSRuntime.InvokeVoidAsync("saveAsFile", fileName, Convert.ToBase64String(pdf.Stream.ToArray()));
        }
        catch (Exception ex)
        {
            // Handle any exceptions that may occur
            Console.Error.WriteLine($"Error in ExportData: {ex.Message}");
        }
    }
}

@using IronPdf

@code {
    /// <summary>
    /// This method exports data by converting a URL to a PDF file and initiating its download.
    /// </summary>
    public async Task ExportData()
    {
        try
        {
            string fileName = "Demo.pdf";
            var renderer = new ChromePdfRenderer();

            // Render the contents of the URL as a PDF document
            var pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata");

            // Save the PDF using a JavaScript function
            await JSRuntime.InvokeVoidAsync("saveAsFile", fileName, Convert.ToBase64String(pdf.Stream.ToArray()));
        }
        catch (Exception ex)
        {
            // Handle any exceptions that may occur
            Console.Error.WriteLine($"Error in ExportData: {ex.Message}");
        }
    }
}

[using] ReadOnly Property code() As IronPdf
	''' <summary>
	''' This method exports data by converting a URL to a PDF file and initiating its download.
	''' </summary>
'INSTANT VB TODO TASK: Local functions are not converted by Instant VB:
'	public async Task ExportData()
'	{
'		try
'		{
'			string fileName = "Demo.pdf";
'			var renderer = New ChromePdfRenderer();
'
'			' Render the contents of the URL as a PDF document
'			var pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata");
'
'			' Save the PDF using a JavaScript function
'			await JSRuntime.InvokeVoidAsync("saveAsFile", fileName, Convert.ToBase64String(pdf.Stream.ToArray()));
'		}
'		catch (Exception ex)
'		{
'			' Handle any exceptions that may occur
'			Console.@Error.WriteLine(string.Format("Error in ExportData: {0}", ex.Message));
'		}
'	}
End Property

Powyższy fragment kodu wykorzystuje dwie metody do generowania dokumentów PDF z HTML. Pierwsza z nich to metoda RenderUrlAsPdf firmy IronPDF, która pobiera zawartość HTML z podanego adresu URL i konwertuje ją do formatu PDF.

Drugą metodą jest metoda statyczna JSRuntime.InvokeVoidAsync, która uruchamia silnik JavaScript przeglądarki w celu wywołania funkcji JavaScript w zakresie strony internetowej, która zapisuje zawartość pliku PDF do pliku w systemie plików klienta.

Poniżej znajduje się ta funkcja JavaScript:

<script type="text/javascript">
    /**
     * Saves the PDF data as a file on the client's system.
     * @param {string} filename - The name of the file to be created.
     * @param {string} bytesBase64 - The Base64 encoded string of the PDF data.
     */
    function saveAsFile(filename, bytesBase64) {
        if (navigator.msSaveBlob) {
            // Download the document in Microsoft Edge browser
            var data = window.atob(bytesBase64);
            var bytes = new Uint8Array(data.length);
            for (var i = 0; i < data.length; i++) {
                bytes[i] = data.charCodeAt(i);
            }
            var blob = new Blob([bytes.buffer], { type: "application/octet-stream" });
            navigator.msSaveBlob(blob, filename);
            window.navigator.msSaveOrOpenBlob(blob);
        }
        else {
            var link = document.createElement('a');
            link.download = filename;
            link.href = "data:application/octet-stream;base64," + bytesBase64;
            document.body.appendChild(link); // Needed for Firefox
            link.click();
            document.body.removeChild(link);
        }
    }
</script>

<script type="text/javascript">
    /**
     * Saves the PDF data as a file on the client's system.
     * @param {string} filename - The name of the file to be created.
     * @param {string} bytesBase64 - The Base64 encoded string of the PDF data.
     */
    function saveAsFile(filename, bytesBase64) {
        if (navigator.msSaveBlob) {
            // Download the document in Microsoft Edge browser
            var data = window.atob(bytesBase64);
            var bytes = new Uint8Array(data.length);
            for (var i = 0; i < data.length; i++) {
                bytes[i] = data.charCodeAt(i);
            }
            var blob = new Blob([bytes.buffer], { type: "application/octet-stream" });
            navigator.msSaveBlob(blob, filename);
            window.navigator.msSaveOrOpenBlob(blob);
        }
        else {
            var link = document.createElement('a');
            link.download = filename;
            link.href = "data:application/octet-stream;base64," + bytesBase64;
            document.body.appendChild(link); // Needed for Firefox
            link.click();
            document.body.removeChild(link);
        }
    }
</script>

Powyższa funkcja JavaScript odbiera dane Base64 z Blazora i konwertuje je na obiekt blob przed zapisaniem w lokalizacji po stronie klienta.

Alternatywnie, do zapisywania dokumentów PDF w lokalnej pamięci przeglądarki można również użyć metody SaveAs z klasy ChromePdfRenderer.