Viewing PDFs in MAUI for C# .NET

W tej sekcji dowiemy się, jak utworzyć stronę przeglądarki PDF, zintegrować przeglądarkę IronPDF oraz utworzyć dla niej kartę w aplikacji MAUI. Pokażemy, jak to zrobić, używając zarówno XAML, jak i C# ContentPage.

Kroki

1. Dodaj nową stronę do swojego 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#). Nadaj plikowi nazwę PdfViewerPage, a następnie kliknij Add.

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

:path=/static-assets/pdf/tutorials/pdf-viewing/pdf-viewing-xaml-1.xml

<?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ś C# ContentPage, dodaj poniższy 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ępujący kod:

:path=/static-assets/pdf/tutorials/pdf-viewing/pdf-viewing-xaml-2.xml

<?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. W lewym górnym rogu powinny być widoczne zakładki, jak pokazano poniżej, a kliknięcie zakładki "PDF Viewer" powinno otworzyć przeglądarkę IronPDF Viewer.

Po uruchomieniu aplikacji IronPDF Viewer domyślnie wyświetli monit o otwarcie pliku PDF. Możliwe jest również automatyczne otwieranie pliku PDF przy uruchomieniu. Istnieją trzy sposoby ładowania pliku PDF podczas uruchamiania: według nazwy pliku, poprzez tablicę bajtów oraz poprzez strumień.

Ładowanie według nazwy pliku

Aby załadować plik PDF według nazwy, można określić źródło pliku PDF w tagu IronPdfView w pliku XAML. Przykład tego przedstawiono poniżej:

:path=/static-assets/pdf/tutorials/pdf-viewing/pdf-viewing-xaml-3.xml

<?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>

IronPdfViewSource.FromFile

Alternatywnie można załadować plik PDF według nazwy, używając metody LoadFromFilename() w C# ContentPage:

: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")

IronPdfViewSource.FromBytes

Wczytanie poprzez tablicę bajtów

W niektórych przypadkach pożądane może być załadowanie tablicy bajtów pliku PDF. Nie jest to możliwe w XAML, ale jest możliwe w C#. Można to osiągnąć, po prostu używając metody LoadFromByteArray(). Przykład zastosowania tej metody przedstawiono poniżej:

: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"))

IronPdfViewSource.FromStream

Ładowanie przez strumień

Podobnie, w niektórych przypadkach bardziej pożądane może być ładowanie plików PDF poprzez strumień. Nie jest to możliwe w XAML, ale jest możliwe w C#. Można to osiągnąć, po prostu używając metody LoadFromStream(). Przykład zastosowania tej metody przedstawiono poniżej:

: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"))

Option