Viewing PDFs in MAUI for C# .NET

Nesta seção, aprenderemos como criar uma página de visualização de PDF, integrar o IronPDF Viewer e criar uma aba para ele em um aplicativo MAUI. Nós demonstraremos como fazer isso com um ContentPage de XAML e C#.

Passos

1. Adicione uma nova página ao seu projeto clicando com o botão direito nele, então navegue até Add > New Item...

2. Navegue até a seção .NET MAUI. Para criar uma página XAML, selecione .NET MAUI ContentPage (XAML). Para um arquivo C#, selecione .NET MAUI ContentPage (C#). Dê ao seu arquivo o nome PdfViewerPage, depois clique Add.

3. No arquivo XAML, adicione o seguinte código e salve:

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

Se você criou um ContentPage de C#, em vez disso, adicione o seguinte código e salve:

: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. No seu arquivo AppShell.xaml, adicione o seguinte:

: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. Salve seu projeto, compile e execute. Você deverá ver abas no canto superior esquerdo, como mostrado abaixo, e clicar na aba "Visualizador de PDF" deverá abrir o Visualizador IronPDF .

Ao iniciar o aplicativo, o IronPDF Viewer solicitará ao usuário que abra um PDF por padrão. Também é possível que ele abra um PDF automaticamente ao iniciar. Existem três maneiras de carregar um PDF na inicialização: por meio de um nome de arquivo, por meio de uma matriz de bytes e por meio de um fluxo.

Carregar por nome de arquivo

Para carregar um PDF pelo nome do arquivo, você pode especificar a fonte do arquivo PDF na tag IronPdfView no arquivo XAML. Um exemplo disso é mostrado abaixo:

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

Alternativamente, você pode carregar o PDF pelo nome do arquivo usando o método IronPdfViewSource.FromFile em um ContentPage de C#:

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

Carregar através de matriz de bytes

Para alguns casos de uso, pode ser desejável carregar uma matriz de bytes de um PDF. Isso não é possível em XAML, mas é possível em C#. Você pode conseguir isso simplesmente utilizando o método IronPdfViewSource.FromBytes. Um exemplo de como usar esse método é mostrado abaixo:

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

Carregar através do fluxo

Da mesma forma, em alguns casos de uso, pode ser mais conveniente que os PDFs sejam carregados por meio de um fluxo. Isso não é possível em XAML, mas é possível em C#. Você pode conseguir isso simplesmente utilizando o método IronPdfViewSource.FromStream. Um exemplo de como usar esse método é mostrado abaixo:

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