IRONSOFTWAREHOME
KORZYSTANIE Z IRONPDF

Jak skanować wiele stron do jednego pliku PDF

Curtis Chau
Curtis Chau
Updated: 21 kwietnia 2026

.NET MAUI to nowa generacja platformy .NET, która umożliwia programistom tworzenie wielopłatformowych aplikacji desktopowych, internetowych i mobilnych, w tym Xamarin.Forms, przy użyciu jednego kodu źródłowego. Dzięki .NET MAUI możesz napisać aplikację raz i wdrożyć ją na wielu platformach, w tym Windows, macOS, iOS, Android i tvOS, zachowując tę samą nazwę projektu. .NET MAUI pozwala również korzystać z najnowszych funkcji interfejsu użytkownika na każdej platformie, takich jak tryb ciemny i obsługa dotykowa w systemie macOS lub rozpoznawanie mowy w systemie Windows 10.

W tym artykułe wyjaśnimy, jak korzystać z IronPDF w aplikacji .NET MAUI, aby tworzyć dokumenty PDF oferujące wiele korzyści.


IronPDF: biblioteka PDF dla języka C#

IronPDF to biblioteka .NET, która umożliwia generowanie i edycję plików PDF. Idealnie nadaje się do stosowania w aplikacjach .NET MAUI, ponieważ oferuje szeroki zakres funkcji, które można dostosować do konkretnych potrzeb. Dzięki łatwemu w użyciu interfejsowi API IronPDF ułatwia integrację funkcji PDF z projektem .NET MAUI.

Wymagania wstępne

Istnieje kilka warunków wstępnych dotyczących tworzenia plików PDF i przeglądarki PDF w .NET MAUI przy użyciu IronPDF:

  1. Najnowsza wersja programu Visual Studio
  2. .NET Framework 6 lub 7
  3. Pakiety MAUI zainstalowane w Visual Studio
  4. Aplikacja .NET MAUI działająca w Visual Studio

Krok 1: Zainstaluj IronPDF

Jednym z najlepszych sposobów zainstalowania IronPDF w nowym projekcie jest użycie konsoli NuGet Package Manager Console w Visual Studio. Korzystanie z tej metody instalacji IronPDF ma kilka zalet.

  • To proste, a
  • Możesz mieć pewność, że korzystasz z najnowszej wersji IronPDF.

Kroki instalacji IronPDF

Najpierw otwórz konsolę menedżera pakietów, przechodząc do menu Narzędzia > Menedżer pakietów NuGet > Konsola menedżera pakietów.

Jak przeglądać PDF w .NET MAUI (krok po kroku) Tutorial, Rysunek 1: Konsola Managera Pakietów Konsola menedżera pakietów

Następnie wpisz następujące polecenie:

PM > Install-Package IronPdf

To zainstaluje pakiet i wszystkie jego zależności, takie jak folder assets.

Jak przeglądać PDF w .NET MAUI (krok po kroku) Tutorial, Rysunek 2: Instalacja IronPDF Instalacja IronPDF

Teraz możesz zacząć korzystać z IronPDF w swoim projekcie MAUI.

Krok 2: Konfiguracja projektu interfejsu użytkownika w .NET MAUI

Najpierw należy stworzyć układ graficzny dla trzech funkcji IronPDF.

URL do układu PDF

W przypadku układu "URL do PDF" należy utworzyć etykietę z tekstem "Wprowadź adres URL, aby przekonwertować plik PDF" przy użyciu kontrolki etykiety .NET MAUI. Następnie zastosuj układ poziomy, aby ustawić kontrolkę Entry i przycisk w linii poziomej. Następnie wstaw linię po elementach sterujących, aby oddzielić kolejną sekcję elementów sterujących.

<Label
    Text="Enter URL to Convert PDF"
    SemanticProperties.HeadingLevel="Level1"
    FontSize="18"
    HorizontalOptions="Center" 
/>
<HorizontalStackLayout
    HorizontalOptions="Center">
    <Border Stroke="White"
            StrokeThickness="2"
            StrokeShape="RoundRectangle 5,5,5,5"
            HorizontalOptions="Center">
        <Entry
            x:Name="URL"
            HeightRequest="50"
            WidthRequest="300" 
            HorizontalOptions="Center"
        />
    </Border>

    <Button
        x:Name="urlPDF"
        Text="Convert URL to PDF"
        Margin="30,0,0,0"
        Clicked="UrlToPdf"
        HorizontalOptions="Center" />
</HorizontalStackLayout>

<Line Stroke="White" X2="1500" />
XML

Układ HTML do PDF

Aby sformatować sekcję HTML do PDF, utwórz kontrolkę Editor oraz przycisk. Kontrolka Editor będzie używana do przyjmowania ciągu znaków treści HTML od użytkownika. Dodatkowo proszę dodać linię jako separator.

<Label
    Text="Enter HTML to Convert to PDF"
    SemanticProperties.HeadingLevel="Level2"
    FontSize="18"
    HorizontalOptions="Center" />
<Border 
    Stroke="White"
    StrokeThickness="2"
    StrokeShape="RoundRectangle 5,5,5,5"
    HorizontalOptions="Center">
    
    <Editor
        x:Name="HTML"
        HeightRequest="200"
        WidthRequest="300" 
        HorizontalOptions="Center"
    />

</Border>

<Button
    x:Name="htmlPDF"
    Text="Convert HTML to PDF"
    Clicked="HtmlToPdf"
    HorizontalOptions="Center" />

<Line Stroke="White" X2="1500" />
XML

Układ pliku HTML do PDF

W przypadku plików HTML do PDF należy dodać tylko jeden przycisk. Ten przycisk pomoże przekonwertować plik HTML na dokument PDF przy użyciu IronPDF.

<Label
    Text="Convert HTML file to PDF"
    SemanticProperties.HeadingLevel="Level2"
    FontSize="18"
    HorizontalOptions="Center" />

<Button
    x:Name="htmlFilePDF"
    Text="Convert HTML file to PDF"
    Clicked="FileToPdf"
    HorizontalOptions="Center" />
XML

Kompletny kod interfejsu użytkownika

Pełny kod źródłowy frontendu .NET MAUI znajduje się poniżej.

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="PDF_Viewer.MainPage">

    <ScrollView>
        <VerticalStackLayout
            Spacing="25"
            Padding="30,0"
            VerticalOptions="Center">
            <Label
                Text="Enter URL to Convert PDF"
                SemanticProperties.HeadingLevel="Level1"
                FontSize="18"
                HorizontalOptions="Center" 
            />
            <HorizontalStackLayout
                HorizontalOptions="Center">
                <Border Stroke="White"
                        StrokeThickness="2"
                        StrokeShape="RoundRectangle 5,5,5,5"
                        HorizontalOptions="Center">
                    <Entry
                        x:Name="URL"
                        HeightRequest="50"
                        WidthRequest="300" 
                        HorizontalOptions="Center"
                    />
                </Border>

                <Button
                    x:Name="urlPDF"
                    Text="Convert URL to PDF"
                    Margin="30,0,0,0"
                    Clicked="UrlToPdf"
                    HorizontalOptions="Center" />
            </HorizontalStackLayout>

            <Line Stroke="White" X2="1500" />

            <Label
                Text="Enter HTML to Convert to PDF"
                SemanticProperties.HeadingLevel="Level2"
                FontSize="18"
                HorizontalOptions="Center" />
            <Border 
                Stroke="White"
                StrokeThickness="2"
                StrokeShape="RoundRectangle 5,5,5,5"
                HorizontalOptions="Center">
                
                <Editor
                    x:Name="HTML"
                    HeightRequest="200"
                    WidthRequest="300" 
                    HorizontalOptions="Center"
                />

            </Border>

            <Button
                x:Name="htmlPDF"
                Text="Convert HTML to PDF"
                Clicked="HtmlToPdf"
                HorizontalOptions="Center" />

            <Line Stroke="White" X2="1500" />

            <Label
                Text="Convert HTML file to PDF"
                SemanticProperties.HeadingLevel="Level2"
                FontSize="18"
                HorizontalOptions="Center" />

            <Button
                x:Name="htmlFilePDF"
                Text="Convert HTML file to PDF"
                Clicked="FileToPdf"
                HorizontalOptions="Center" />
        </VerticalStackLayout>
    </ScrollView>

</ContentPage>
XML

Krok 3: Kod do zapisywania i przeglądania plików PDF

.NET MAUI nie posiada żadnej wbudowanej funkcji do zapisywania plików w lokalnej pamięci. W związku z tym konieczne jest samodzielne napisanie kodu. Aby stworzyć funkcjonalność zapisu i wyświetlania, stworzono klasę cząstkową nazwaną SaveService z cząstkową funkcją void nazwaną SaveAndView z trzema parametrami: nazwą pliku, typem zawartości pliku i strumieniem pamięci do zapisu pliku.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace PDF_Viewer
{
    public partial class SaveService
    {
        public partial void SaveAndView(string filename, string contentType, MemoryStream stream);
    }
}

Funkcje zapisywania i przeglądania będą musiały zostać zaimplementowane dla każdej platformy, która ma być obsługiwana (np. dla systemów Android, macOS i/lub Windows). Dla platformy Windows, stwórz plik o nazwie 'SaveWindows.cs' i zaimplementuj cząstkową metodę SaveAndView:

using Windows.Storage;
using Windows.Storage.Pickers;
using Windows.Storage.Streams;
using Windows.UI.Popups;

namespace PDF_Viewer
{
    public partial class SaveService
    {
        public async partial void SaveAndView(string filename, string contentType, MemoryStream stream)
        {
            StorageFile stFile;
            string extension = Path.GetExtension(filename);
            //Gets process windows handle to open the dialog in application process.
            IntPtr windowHandle = System.Diagnostics.Process.GetCurrentProcess().MainWindowHandle;
            if (!Windows.Foundation.Metadata.ApiInformation.IsTypePresent("Windows.Phone.UI.Input.HardwareButtons"))
            {
                //Creates file save picker to save a file.
                FileSavePicker savePicker = new FileSavePicker();
                savePicker.DefaultFileExtension = ".pdf";
                savePicker.SuggestedFileName = filename;
                //Saves the file as PDF file.
                savePicker.FileTypeChoices.Add("PDF", new List<string>() { ".pdf" });
                

                WinRT.Interop.InitializeWithWindow.Initialize(savePicker, windowHandle);
                stFile = await savePicker.PickSaveFileAsync();
            }
            else
            {
                StorageFolder local = ApplicationData.Current.LocalFolder;
                stFile = await local.CreateFileAsync(filename, CreationCollisionOption.ReplaceExisting);
            }
            if (stFile != null)
            {
                using (IRandomAccessStream zipStream = await stFile.OpenAsync(FileAccessMode.ReadWrite))
                {
                    //Writes compressed data from memory to file.
                    using Stream outstream = zipStream.AsStreamForWrite();
                    outstream.SetLength(0);
                    //Saves the stream as file.
                    byte [] buffer = stream.ToArray();
                    outstream.Write(buffer, 0, buffer.Length);
                    outstream.Flush();
                }
                //Create message dialog box.
                MessageDialog msgDialog = new("Do you want to view the document?", "File has been created successfully");
                UICommand yesCmd = new("Yes");
                msgDialog.Commands.Add(yesCmd);
                UICommand noCmd = new("No");
                msgDialog.Commands.Add(noCmd);

                WinRT.Interop.InitializeWithWindow.Initialize(msgDialog, windowHandle);

                //Showing a dialog box.
                IUICommand cmd = await msgDialog.ShowAsync();
                if (cmd.Label == yesCmd.Label)
                {
                    //Launch the saved file.
                    await Windows.System.Launcher.LaunchFileAsync(stFile);
                }
            }
        }
    }
}

Dla Androida i macOS, musisz stworzyć oddzielne pliki z porównywalnymi implementacjami SaveAndView. Przykład działającego rozwiązania można znaleźć w repozytorium GitHub MAUI PDF Viewer.

Krok 4: Kod funkcji PDF

Teraz nadszedł czas na napisanie kodu dla funkcji PDF. Zacznijmy od funkcji konwersji adresów URL do formatu PDF.

Funkcja konwersji URL na PDF

Stwórz funkcję UrlToPdf dla funkcjonalności URL do PDF. Wewnątrz funkcji, stwórz instancję obiektu ChromePdfRenderer i użyj funkcji RenderUrlAsPdf do konwersji URL na dokumenty PDF. Funkcja RenderUrlAsPdf pobiera dane URL z serwera sieciowego i przetwarza je, aby przekonwertować na dokument PDF. W parametrach przekaż tekst w kontrolce wpisu URL, stwórz obiekt klasy SaveService i użyj funkcji SaveAndView. W parametrach funkcji SaveAndView przekaż strumień wygenerowanego pliku PDF.

Funkcja SaveAndView pomaga zapisać pliki w dowolnej dostosowanej ścieżce i daje możliwość przeglądania plików PDF. Na koniec wyświetl okno z informacją o tworzeniu pliku PDF. Jeśli użytkownik spróbuje utworzyć plik PDF z pustym polem, wyświetli się okno z komunikatem o błędzie i ostrzeżeniem.

private void UrlToPdf(object sender, EventArgs e)
{
    if (!string.IsNullOrEmpty(URL.Text))
    {
        var renderer = new IronPdf.ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf(URL.Text.Trim());
        SaveService saveService = new SaveService();
        saveService.SaveAndView("URLtoPDF.pdf", "application/pdf", pdf.Stream);
        DisplayAlert("Success", "PDF from URL Created!", "OK");
    }
    else
    {
        DisplayAlert("Error", "Field can't be empty! \nPlease enter URL!", "OK");
    }

}

Funkcja konwersji HTML do PDF

Aby utworzyć funkcjonalność konwersji HTML do PDF, stwórz funkcję HtmlToPdf i użyj funkcji RenderHtmlAsPdf. Użyj tekstu z kontrolki Edytora i przekaż go w parametrach funkcji RenderHtmlAsPdf. Podobnie jak w powyższej funkcji, użyj funkcji SaveAndView, aby umożliwić funkcjonalność przeglądania pliku PDF po zapisaniu.

private void HtmlToPdf(object sender, EventArgs e)
{
    if (!string.IsNullOrEmpty(HTML.Text))
    {
        var renderer = new IronPdf.ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf(HTML.Text);
        SaveService saveService = new SaveService();
        saveService.SaveAndView("IronPDF HTML string.pdf", "application/pdf", pdf.Stream);
        DisplayAlert("Success", "PDF from HTML Created!", "OK");
    }
    else
    {
        DisplayAlert("Error", "Field can't be empty! \nPlease enter valid HTML!", "OK");
    }
}

Funkcja konwersji plików HTML do formatu PDF

Stwórz funkcję FileToPdf do konwersji plików HTML na pliki PDF. Użyj funkcji RenderHtmlFileAsPdf i przekaż ścieżkę pliku HTML jako parametr. Konwertuje całą zawartość HTML do formatu PDF i zapisuje plik wyjściowy.

private void FileToPdf(object sender, EventArgs e)
{
    var renderer = new IronPdf.ChromePdfRenderer();
    var pdf = renderer.RenderHtmlFileAsPdf(@"C:\Users\Administrator\Desktop\index.html");
    SaveService saveService = new SaveService();
    saveService.SaveAndView("HTML File to PDF.pdf", "application/pdf", pdf.Stream);
    DisplayAlert("Success", "PDF from File Created!", "OK");
}

Wynik

Po uruchomieniu projektu wynik będzie wyglądał następująco.

Jak przeglądać PDF w .NET MAUI (krok po kroku) Tutorial, Rysunek 3: Wynik Wynik

Wpisz adres URL strony Microsoftu w tej sekcji i kliknij przycisk.

Jak przeglądać PDF w .NET MAUI (krok po kroku) Tutorial, Rysunek 4: URL do PDF URL do pliku PDF

Po utworzeniu pliku PDF wyświetla się okno dialogowe umożliwiające zapisanie pliku w wybranej lokalizacji.

Jak przeglądać PDF w .NET MAUI (krok po kroku) Tutorial, Rysunek 5: Zapisz Plik Zapisz plik

Po zapisaniu pliku pojawia się to okienko, które umożliwia wybranie przeglądarki PDF do wyświetlenia pliku.

Jak przeglądać PDF w .NET MAUI (krok po kroku) Tutorial, Rysunek 6: Wyskakujące okienko Przeglądarki PDF Wyskakujące okienko przeglądarki PDF

IronPDF znakomicie konwertuje adresy URL do formatu PDF. Zachowuje wszystkie kolory i obrazy w ich oryginalnym kształcie i formatowaniu.

Jak przeglądać PDF w .NET MAUI (krok po kroku) Tutorial, Rysunek 7: Wyskakujące okienko Przeglądarki PDF Wyskakujące okienko przeglądarki PDF

Tę samą procedurę należy zastosować w odniesieniu do wszystkich pozostałych funkcji. Zapoznaj się z tym wpisem na blogu IronPDF w Blazor, aby dowiedzieć się więcej o działaniu IronPDF w Blazor.

Dowiedz się, jak przekonwertować stronę MAUI jako XAML na dokument PDF, odwiedzając "Jak Konwertować XAML do PDF w MAUI".

Podsumowanie

W tym samouczku wykorzystano IronPDF w aplikacji .NET MAUI do utworzenia pliku PDF i przeglądarki PDF. .NET MAUI to doskonałe narzędzie do tworzenia aplikacji wielopłatformowych w oparciu o jedną bazę kodu. IronPDF pomaga w łatwym tworzeniu i dostosowywaniu plików PDF w dowolnej aplikacji .NET. IronPDF jest w pełni kompatybilny z platformą .NET MAUI.

IronPDF jest bezpłatny do celów programistycznych. Możesz otrzymać bezpłatny klucz próbny, aby przetestować IronPDF w środowisku produkcyjnym. Aby uzyskać więcej informacji na temat IronPDF i jego możliwości, odwiedź oficjalną stronę internetową IronPDF.

Curtis Chau
Autor tekstów technicznych

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.

...
Czytaj więcej

Powiązane artykuły

Key in blue circle

Uzyskaj natychmiast swój darmowy 30-dniowy Klucz Testowy.

Brak ograniczeń. 100% dostępności. Bez karty kredytowej.

bullet_checkedNie wymaga karty kredytowej ani tworzenia kontaBrak ograniczeń. 100% dostępności. Bez karty kredytowej.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Zarezerwuj swoje darmowe Demo na żywo
Booking Badge

Zaufane przez miliony inżynierów na całym świecie

Logotypy klientów Iron Software
Otrzymaj swoje Konsultacja Bez Zobowiązań
Wypełnij poniższy formularz lub wyślij e-mail na sales@ironsoftware.com
Twoje dane zawsze będą utrzymywane w tajemnicy.
Zaufane przez miliony inżynierów na całym świecie
Logotypy klientów Iron Software
Otrzymaj swój darmowy Klucz Próbny na 30 dni natychmiast.
Nie wymaga karty kredytowej ani tworzenia konta