Viewing PDFs in MAUI for C# .NET

Ta sekcja obejmuje, jak utworzyć stronę przeglądarki PDF, zintegrować IronPDF Viewer i utworzyć dla niej zakładkę w aplikacji MAUI. Pokazujemy to zarówno z XAML, jak i z ContentPage w języku C#. Wybierz podejście, które najlepiej pasuje do stylu rozwoju i wymagań projektu.

Jakie są kroki, aby dodać stronę przeglądarki?

1. Dodaj nową stronę do projektu, klikając prawym przyciskiem myszy na projekt, a następnie przejdź do Add > New Item...

2. Przejdź do sekcji .NET MAUI. Aby utworzyć stronę XAML, wybierz .NET MAUI ContentPage (XAML). W przypadku pliku C# wybierz .NET MAUI ContentPage (C#). Nazwij swój plik PdfViewerPage, a następnie kliknij Add.
   

3. W pliku XAML dodaj następujący kod i zapisz:

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage ...
    xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
    ...>
    <ipv:IronPdfView x:Name="pdfView"/>
</ContentPage>

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage ...
    xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
    ...>
    <ipv:IronPdfView x:Name="pdfView"/>
</ContentPage>

Jeśli zamiast tego utworzyłeś ContentPage w języku C#, dodaj następujący kod i zapisz:

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-3.cs

using IronPdf.Viewer.Maui;

public class MainPage : ContentPage
{
    private readonly IronPdfView pdfView;

    public MainPage()
    {
        InitializeComponent();

        this.pdfView = new IronPdfView { Options = IronPdfViewOptions.All };

        Content = this.pdfView;
    }
}

Imports IronPdf.Viewer.Maui

Public Class MainPage
	Inherits ContentPage

	Private ReadOnly pdfView As IronPdfView

	Public Sub New()
		InitializeComponent()

		Me.pdfView = New IronPdfView With {.Options = IronPdfViewOptions.All}

		Content = Me.pdfView
	End Sub
End Class

4. W pliku AppShell.xaml dodaj następne, aby utworzyć zakładki nawigacyjne:

<?xml version="1.0" encoding="UTF-8" ?>
<Shell ...
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
    ...>
  <TabBar x:Name="AppTabBar">
      <Tab Title="Home">
        <ShellContent ContentTemplate="{DataTemplate local:MainPage}" Route="MainPage"/>
      </Tab>
      <Tab Title="PDF Viewer">
        <ShellContent ContentTemplate="{DataTemplate local:PdfViewerPage}" Route="PDFViewer"/>
    </Tab>
  </TabBar>
</Shell>

<?xml version="1.0" encoding="UTF-8" ?>
<Shell ...
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
    ...>
  <TabBar x:Name="AppTabBar">
      <Tab Title="Home">
        <ShellContent ContentTemplate="{DataTemplate local:MainPage}" Route="MainPage"/>
      </Tab>
      <Tab Title="PDF Viewer">
        <ShellContent ContentTemplate="{DataTemplate local:PdfViewerPage}" Route="PDFViewer"/>
    </Tab>
  </TabBar>
</Shell>

5. Zapisz projekt, a następnie zbuduj i uruchom. Powinieneś zobaczyć zakładki w lewym górnym rogu, jak pokazano poniżej. Kliknięcie zakładki "PDF Viewer" otwiera IronPDF Viewer. Przeglądarka oferuje bogaty w funkcje interfejs do interakcji z dokumentami PDF.

Podczas uruchamiania aplikacji IronPDF Viewer domyślnie wyświetla monit o otwarcie PDF-a. Jednakże, może otworzyć PDF automatycznie przy starcie, co poprawia doświadczenie użytkownika w aplikacjach, które muszą natychmiast wyświetlać konkretne dokumenty. Możesz załadować PDF przy starcie na trzy sposoby: po nazwie pliku, przez tablicę bajtów i przez strumień. Każda metoda oferuje różne zalety, w zależności od źródła danych i architektury aplikacji.

Jak załadować przez nazwę pliku?

Aby załadować PDF po nazwie pliku, określ źródło pliku PDF w znaku IronPdfView w pliku XAML. Jest to najprostsze podejście przy pracy z lokalnymi plikami:

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage ...
    xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
    ...>
    <ipv:IronPdfView Source="C:/path/to/my/example.pdf" />
</ContentPage>

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage ...
    xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
    ...>
    <ipv:IronPdfView Source="C:/path/to/my/example.pdf" />
</ContentPage>

Alternatywnie, załaduj PDF po nazwie pliku programowo, używając metody IronPdfViewSource.FromFile w ContentPage w języku C#. To podejście oferuje większą elastyczność w ładowaniu dynamicznych plików:

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-4.cs

// We assume an IronPdfView instance is created previously called pdfView
pdfView.Source = IronPdfViewSource.FromFile("C:/path/to/my/example.pdf");

' We assume an IronPdfView instance is created previously called pdfView
pdfView.Source = IronPdfViewSource.FromFile("C:/path/to/my/example.pdf")

Jak załadować przez tablicę bajtów?

Przy pracy z PDF-ami przechowywanymi w bazach danych lub otrzymywanymi z usług internetowych, możesz potrzebować załadować tablicę bajtów PDF. To nie jest możliwe z poziomu XAML, ale można to osiągnąć w C# używając metody IronPdfViewSource.FromBytes:

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-5.cs

pdfView.Source = IronPdfViewSource.FromBytes(File.ReadAllBytes("~/Downloads/example.pdf"));

pdfView.Source = IronPdfViewSource.FromBytes(File.ReadAllBytes("~/Downloads/example.pdf"))

Ta metoda jest przydatna przy integracji z systemami zarządzania dokumentami lub gdy PDF-y są generowane dynamicznie, korzystając z możliwości IronPDF do konwersji HTML na PDF.

Jak załadować przez strumień?

Dla PDF-ów ładowanych przez strumień, szczególnie przy pracy z zasobami sieciowymi lub przy implementacji ładowania postępowego, użyj metody IronPdfViewSource.FromStream w C#:

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-6.cs

pdfView.Source = IronPdfViewSource.FromStream(File.OpenRead("~/Downloads/example.pdf"));

pdfView.Source = IronPdfViewSource.FromStream(File.OpenRead("~/Downloads/example.pdf"))

Ładowanie oparte na strumieniu jest idealne do efektywnego obsługiwania dużych PDF-ów lub pracy z zaszyfrowanymi strumieniami dokumentów.