Viewing PDFs in MAUI for C# .NET

Esta seção aborda como criar uma página de visualização de PDF, integrar o IronPDF Viewer e criar uma aba para ele em um aplicativo MAUI. Demonstramos isso com XAML e C# ContentPage. Escolha a abordagem que melhor se adapte ao seu estilo de desenvolvimento e aos requisitos do projeto.

Quais são os passos para adicionar uma página de visualizador?

1. Adicione uma nova página ao seu projeto clicando com o botão direito do mouse sobre o projeto e navegando 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 e clique em Add.
   

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

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

Se você criou um arquivo C# ContentPage 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 para criar as abas de navegação:

<?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. Salve seu projeto, compile e execute. Você deverá ver abas no canto superior esquerdo, como mostrado abaixo. Clicar na aba "Visualizador de PDF" abre o Visualizador IronPDF . O visualizador oferece uma interface rica em recursos para interação com documentos PDF.

Ao iniciar o aplicativo, o IronPDF Viewer solicita ao usuário que abra um PDF por padrão. No entanto, ele pode abrir um PDF automaticamente na inicialização, o que melhora a experiência do usuário para aplicativos que precisam exibir documentos específicos imediatamente. Você pode carregar um PDF na inicialização de três maneiras: pelo nome do arquivo, por meio de uma matriz de bytes e por meio de um fluxo. Cada método oferece diferentes vantagens dependendo da sua fonte de dados e da arquitetura da aplicação.

Como faço para carregar um arquivo pelo nome?

Para carregar um PDF pelo nome do arquivo, especifique a origem do arquivo PDF na tag IronPdfView no arquivo XAML. Esta é a abordagem mais simples ao trabalhar com arquivos locais:

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

Alternativamente, carregue o PDF pelo nome do arquivo programaticamente usando o método IronPdfViewSource.FromFile em um ContentPage em C#. Essa abordagem oferece mais flexibilidade para o carregamento dinâmico de arquivos:

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

Como faço para carregar dados através de um array de bytes?

Ao trabalhar com PDFs armazenados em bancos de dados ou recebidos de serviços da web, pode ser necessário carregar uma matriz de bytes de um PDF. Isso não é possível em XAML, mas você pode conseguir em C# usando o método 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"))

Este método é útil ao integrar com sistemas de gerenciamento de documentos ou quando PDFs são gerados dinamicamente usando os recursos de conversão de HTML para PDF do IronPDF .

Como faço para carregar através de um fluxo de dados?

Para PDFs carregados por meio de um fluxo, especialmente ao trabalhar com recursos de rede ou implementar carregamento progressivo, use o método IronPdfViewSource.FromStream em 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"))

O carregamento baseado em fluxo é ideal para lidar com PDFs grandes de forma eficiente ou para trabalhar com fluxos de documentos criptografados.